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Limited Warranty on Media and Manuals 

ALL IMPLIED WARRANTIES ON THE MEDIA AND MANUAL, 
INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE, ARE LIMITED IN 
DURATION TO NINETY (90) DAYS FROM THE DATE OF THE 
ORIGINAL RETAIL PURCHASE OF THIS PRODUCT. 

Even though Apple has tested the software and reviewed the documentation, APPLE 
MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS 
OR IMPLIED, WITH RESPECT TO THIS SOFTWARE OR ITS 
DOCUMENTATION, ITS QUALITY, PERFORMANCE, 
MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. 
AS A RESULT, THIS SOFTWARE AND ITS DOCUMENTATION ARE 
SOLD "AS IS," AND YOU, THE PURCHASER, ARE ASSUMING THE 
ENTIRE RISK AS TO THEIR QUALITY AND PERFORMANCE. 

IN NO EVENT WILL APPLE BE LIABLE FOR DIRECT, INDIRECT, 
SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES 
RESULTING FROM ANY DEFECT IN THE SOFTWARE OR ITS 
DOCUMENTATION, even if advised of the possibility of such damages. In particular, 
Apple shall have no liability for any programs or data stored in or used with Apple 
products, including the costs of recovering such programs or data. 

THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE 
EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL OR WRITTEN, 
EXPRESS OR IMPLIED. No Apple dealer, agent, or employee is authorized to make 
any modification, extension, or addition to this warranty. 

Some states do not allow the exclusion or limitation of implied warranties or liability for 
incidental or consequential damages, so the above limitation or exclusion may not apply to 
you. This warranty gives you specific legal rights, and you may also have other rights 
which vary from state to state. 
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The released version of Workshop C 
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of someone with a Beta version, 
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Preface 



This manual contains information you need to write C programs for the Macintosh™ by developing, 
compiling, and linking your programs under the Lisa® Workshop. Workshop C consists of a C compiler 
developed by Green Hills Software, the Standard C Library, and the Macintosh Interface Libraries. 

Contents of this Manual 

This manual contains the following sections: 

• Section 1 ... a definition of the Workshop C Language. 

• Section 2. . .a clarification of implementation-specific details of the language definition. 

• Section 3. . .notes describing calling conventions and other implementation issues. 

• Section 4. . .details on how to run the compiler, including a list of compiler options. 

• Section 5 ... a list of library files and notes on when to link with each file. 

• Section 6. . .a complete definition of the Standard C Library provided with Workshop C. 

• Section 7. . .the C definition of the Macintosh Interface Libraries. 

• Section 8 ... a combined index to the Standard C Library and the Macintosh Interface Libraries. 

Reference Materials 

You'll need to be familiar with these additional reference materials: 

• Lisa Workshop User's Guide, Pascal Workshop 3.0, Apple Computer Inc. 

• The C Programming Language, Kernighan and Ritchie (Prentice-Hall, 1978). 

• Inside Macintosh. 

• Apple Numerics Manual. 

' "Putting Together A Macintosh Application," Macintosh Software Supplement, Apple 
Computer Inc. 

Inside Macintosh and the Apple Numerics Manual will be published by Addison-Wesley in late 
1985. A preliminary, promotional edition of Inside Macintosh is currently available from Apple 
Computer. The contents of the Apple Numerics Manual are available in the "Standard Apple Numeric 
Environment" manual in the Lisa Systems Software binder of the Pascal Workshop 3.0 documentation. 
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Installation Notes 

Lisa Workshop C is intended for use with the May 1985 Macintosh Software Supplement, which includes 
the Lisa Workshop 3.9. The files listed below are on the Workshop C release disks. They may be used 
directly or copied to a hard disk. 



Compiler 




compiler 


cobj Version 1.8 


Macintosh Sample Program 




makefile 
source 
resource file 


mac/c/make.text 

mac/c/sample/qdsample.c.text 

mac/c/sample/qdsample.r.text 


Macintosh Libraries 




headers 
objects 


mac/c/include/. . . .h.text 
mac/c/lib/ — obj 
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1. The Workshop C Language 

Workshop C is a complete implementation of the C programming language. The C Programming 
Language by Kernighan and Ritchie (Prentice-Hall, 1978) is currently the most authoritative written 
definition of C. However, the language has changed in several ways since the book was written. In 
addition, numerous details of the language definition are open to interpretation. Therefore, the de facto 
standaid definition of C differs in several ways from the language originally defined by Kernighan and 
Ritchie. This de facto standard is loosely defined by the Portable C Compiler (PCC), the most widely used 
implementation of C. 

Standard C is our name for the de facto standard definition of C as defined and implemented by the 
Berkeley 4.2 BSD VAX implementation of PCC, including the documented Western Electric extensions. 
Workshop C is based on this de facto standard (not on the proposed ANSI standard currently under 
development). 

In addition, Apple has extended the standard language definition in several ways to facilitate writing 
programs for the Macintosh. Workshop C includes type void, enumeration data types, structure function 
parameters and results, enumeration data types, and a function modifier that allows calls to and from Pascal 
programs and the Macintosh Interface Libraries. The language has built-in support for the Standard Apple 
Numeric Environment (SANE). It recognizes the SANE data types, uses SANE for all C floating-point 
operations and conversions, and correcdy handles NaNs (Not-a-Number) and infinities in comparisons and in 
ASCII-binary conversions. The language together with the SANE library support comprise a scrupulously 
conforming implementation of extended-precision IEEE Standard 754 floating-point arithmetic. 
Furthermore^ source programs written using only float and double types and standard C operations compile 
and run without modification. These and other extensions are discussed in detail below. 

1.1 Data Types 

The table below lists the arithmetic and pointer types available in Workshop C, and the number of bits 
allocated for variables of these types. Types int and longint, which are identical in this implementation, 
represent 32-bit integers. Pointers also require 32 bits. Enumeration types are allocated either 8, 16, or 32 
bits, depending on the range of the enumeration literal values. 

Description 

range -128 to 127 

range to 255 

range -32,768 to 32,767 

range to 65,535 

range -2,147,483,648 to 2,147,483,647 

Page 3 
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char 
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unsigned char 
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short 


16 


unsigned short 


16 


int 


32 
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1.2 



unsigned 


int 


32 


long 




32 


unsigned long 


32 


enum 




8, 16 or 32 


* 




32 


float 




32 


double 




64 


comp 




64 


extended 




80 


Type 


Void 





range to 4,294,967,295 

range -2,147,483,648 to 2,147,483,647 

range to 4,294,967,295 

depends on die range of the enumeration literals 

pointer types 

IEEE single-precision floating point 

IEEE double-precision floating point 

SANE signed integral values 

IEEE extended-precision floating point 



Type void has no values and no operators. Type void may be used as a type specifier in function 
declarations to indicate that the function has no meaningful return value. Specifying type void in Pascal- 
compatible function declarations reduces the number of instructions generated in calling the function. (See 
Section 1.10, Pascal-Compatible Functions.) 

1.3 Type Enum 

Type enum is a type analogous to the enumeration types of Pascal. Its syntax is similar to that of the 
struct and union declarations: 

enum- specifier: 

enum { enum-list } 

enum identifier { enum-list } 

enum identifier 

enum-list: 

enumeration-declaration 
enumeration-declaration enum-list 

enumeration-declaration: 
identifier 
identifier = constant-expression 

The first identifier in eaum-specifier, like the structure tag in a stniet-speeifier, names a particular 
enumeration. For example, 

enum color {chartreuse, burgundy, claret, winedark}; 

enum color *cp, col; 

This enumeration makes color the enumeration tag of a type describing various colors and then declares cp 
as a pointer to an object of that type and col as an object of that type. 

The identifiers in enum-list are declared as constants and may appear wherever Constants are required. If 
no enumerators with a constant-expression appear, the values of the constants begin at and increase 
by 1 as the declaration is read from left to right. An enumerator with a constant-expression gives the 
associated identifier the value indicated; subsequent identifiers continue the progression by 1 from the 

assigned value. 

Enumeration tags and constants must be unique. They are drawn from the set of ordinary identifiers, unlike 
structure tags and members. Objects of a given enumeration type have a type distinct from objects of all 
other types. 
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1.4 Register Variables 

The compiler allocates automatic variables in registers whenever possible. Register variables will be 
assigned to registers before other automatic variables. Enumeration, character, integer, and pointer variables 
qualify for register allocation unless their address is taken with the & operator. Floating-point variables are 
not allocated to registers. 

Several data and address registers are available for use as automatic variables. The exact number depends on 
the calling conventions being used The number of variables allocated to registers may exceed the total 
number of registers. Several variables whose useful lifetimes do not overlap may be assigned to the same 
register. Often all of the eligible variables within a function will reside in registers, rather than on the 
stack. 



1.5 Structures 

Structures may be assigned, passed as parameters, and returned as function results. The left and right sides 
of a structure assignment must have the same type. Similiarly, actual and formal parameters must have 
identical types. Other plausible operators, such as equality comparison, have not been implemented. 

Warning: In functions that return structures, if an interrupt occurs during the return sequence and the same 
function is called reentrantly during (the interrupt, the value returned from the first call may be corrupted. 
The problem can occur only in the presence of interrupts. Recursive calls are quite safe. 

1.6 Return, Newline, and Vertical Tab 

The Return character, rather than newline, is represented by \n (a backslash character followed by a 
lowercase n). Return is the usual line termination character on the Macintosh. Return can also be 
represented by \r. Vertical tab is represented by \v. 

1.7 LINE and FILE 



_ _LINE_ _ is a predefined preprocessor symbol whose value is the current line number within the current 

source file. FILE_ _ is a similiar symbol whose value is a character string consisting of the current file 

name. Both symbols begin and end with two underscore characters. 

1.8 Predefined Symbols 

The symbols MC68000, mc68000, m68k, ghs, and macintosh are predefined. Each of the symbols 
has the value 1 , as if a statement of this form had appeared at the beginning of the source code: 

fdefine MC68000 1 



1.9 Standard Apple Numeric Environment Extensions 

The Standard Apple Numeric Environment (SANE) is an extended-precision version of the IEEE Standard 
for Binary Floating-Point Arithmetic (754), together with an extra data type and basic functions for 
application development. Workshop C supports this environment Much of SANE is provided through the 
run-time library sanelib and its include file sane.h. However, to use extended-precision arithmetic 
efficiently and effectively, and to handle IEEE NaNs (Not-a-Number) and infinities, some extensions to 
standard C are required. 
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A change from double to extended as the basic floating-point type is the most salient change to standard C. 
Since C was originally developed on the DEC PDP-1 1, the PDP-1 1 architecture is reflected in standard C in 
the use of float and double as floating-point types, with double as the basic type: floating-point 
expressions are evaluated to double, anonymous variables are double, and floating-point parameters and 
function results are passed as doubles. However, die low-level SANE arithmetic (as well as the floating- 
point chips Intel 8087, Motorola 68881, and Zilog Z8070) evaluates arithmetic operations to the range and 
precision of an 80-bit extended type. Thus, extended naturally replaces PDP-1 1 double as the basic 
arithmetic type for computing purposes. The types float (IEEE single), double, and comp serve as space- 
saving storage types, just as float does in conventional C. 

The IEEE Standard specifies two special representations for its floating-point formats: NaNs (Not-a- 
Number) and infinities. Workshop C expands the syntax for I/O to accommodate NaNs and infinities, and 
includes the treatment of NaNs in relationals as required by the IEEE Standard. 

The SANE extensions to standard C are backward compatible: programs written using only float and 
double floating-point types and standard C operations compile and run without modification. SANE does 
not affect integer arithmetic. 

The Apple Numerics Manual contains detailed documentation of the Standard Apple Numeric 
Environment. 



1.9.1 Constants 

Numeric constants that include floating-point syntax— a point (.) or an exponent field— or that lie outside 
the range of longint are of type extended. Decimal-to-binary conversion for numeric constants is done at 
compile time (and hence is governed by the default numeric environment; compare Section 1 .9.6). 

1.9.2 Expressions 

The SANE types— float, double, comp, and extended— can be mixed in expressions with each other and 
with integer types in the same manner that float and double can in standard C. An expression consisting 
solely of a SANE-type variable, constant, or function is of type extended. An expression formed by 
subexpressions and an arithmetic operation is of type extended if either of its subexpressions is. Extended- 
type expressions are evaluated using extended-precision SANE arithmetic, with conversions to type extended 
generated automatically as needed. Parentheses in extended-type expressions are honored Initialization of 
external and static variables, which may include expression evaluation, is done at compile time; all other 
evaluation of extended-type expressions is done at run time. 

1.9.3 Comparisons 

The result of a comparison involving a NaN operand is unordered. The usual trichotomy of numbers is 
expanded to less (<), greater (>), equal (==), and unordered. For example, the negation of "a less than b" is 
not "a greater than or equal to b" but "(a greater than or equal to b) OR (a and b unordered)". 

1.9.4 Functions 

A numeric actual parameter passed by value is an expression and hence is of extended or integer type. All 
extended-type arguments are passed as extendeds. Similarly, all results of functions declared float, double, 
comp, or extended are returned as extendeds. 
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1.9.5 Input/Output 



In addition to the usual syntax accepted for numeric input, the Standard C Library function scanf 
recognizes "INF" as infinity and "NAN" as a NaN. NAN may be followed by parentheses, which may 
contain an integer (a code indicating the NaN's origin). INF and NAN are optionally preceded by a sign and 
are case insensitive. Scanf specifiers for SANE types extend standard C as follows: conversion characters 
f, e, and g indicate type float; If, le, and lg indicate type double; mf, me, and mg indicate type comp; 
and ne, nf, and ng indicate type extended. 

The Standaid C Library function printf writes infinities as [-]MF and NaNs as [-]NAN(ddd), where ddd is 
the NaN code. 

1.9.6 Numeric Environment 

The numeric environment refers to rounding direction, rounding precision, halt enables, and exception flags. 
IEEE Standard defaults— rounding to nearest, rounding to extended precision, and all halts disabled— are in 
effect for compile-time arithmetic (including decimal-to-binary conversion). Each program begins with 
these defaults and with all exception flags clear. Functions for managing the environment are included in 
the library sanelib. The compiler, in optimizing, will not change any part of the numeric environment, 
including the exception-flag setting which is a side effect of arithmetic operations. 

1.9.7 SANE Library 

The SANE library rounds out the IEEE Standard implementation and provides the basic tools for developing 
a wide range of applications. The SANE library includes the following: 

logarithmic, exponential, and trigonometric functions 

financial functions 

random number generation 

binary-decimal conversion 

numeric scanning and formatting 

environment control 

other functions required or recommended by the IEEE Standard 

Additional information can be found under the SANE entry in the Macintosh Interface Libraries section. 

1.9.8 SANE Programming 

Workshop C's automatic use of the extended type produces results that are generally better than those of 
other C systems. Extended precision yields more accuracy and extended range avoids unnecessary underflow 
and overflow of intermediate results. The programmer can further exploit the extended type by declaring all 
floating-point temporary variables to be type extended. This is both time- and space-efficient, since it 
reduces the number of automatic conversions among types. External data should be stored in one of the 
three smaller SANE types (float, double, or comp), not only for economy but also because the extended 
format may vary among SANE implementations. As a general rule, use float, double, or comp data as 
program input; extended arithmetic for computations; and float, double, or comp data as program output. 

In many instances, IEEE arithmetic allows simpler algorithms than were possible without IEEE arithmetic. 

The handling of infinities enlarges the domain of some formulas. For example, 1 + 1/x^ computes correctly 

even if x^ overflows. Running with halts disabled (the default), a program will never crash due to a 
floating-point exception. Hence by monitoring exception flags a program can test for exceptional cases 
after the fact. The alternative of screening out bad input is often infeasible, sometimes impossible. 
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1.10 Pascal-Compatible Functions 

The function-calling conventions used by Workshop C and Pascal differ radically in the order of parameters 
on the stack, the type coercions applied to parameters, the location of the return result, and the number of 
scratch registers. C has been extended to allow function calls between these languages. The specifier 
pascal in a function declaration or definition indicates a Pascal-compatible function. 

1.10.1 Pascal-Compatible Function Declarations 

A function or procedure written in Pascal (or written in assembly language following Pascal calling 
conventions) can be called from C. A Pascal-compatible external function declaration begins with the 
pascal specifier, contains the usual type specifiers, function name, and parameter list, and must also 
contain declarations for the parameters, followed by the word extern. Parameters whose declarations are 
omitted are assumed to be type int. For example, the C function declaration 

pascal void DrawText (tesxtBuf , f irstByte, byteCount) 
Ptr textBuf; 
short firstByte, byteCount; 

extern; 

would allow a C program to call the procedure DrawText defined in Pascal as follows: 

PROCEDURE DrawText (textBuf : Ptr; firstByte, byteCount: INTEGER); 

Pascal-compatible function declarations are used in the Macintosh Interface Libraries to allow C programs 
to directly call Macintosh library routines that use Pascal calling conventions. The word extern may be 
followed by a constant, which is interpreted as a 16-bit 68000 instruction that replaces the usual subroutine 
call (JRS) instruction in the calling sequence. This allows direct traps to the Macintosh ROM. For 
example: 

pascal void OpenPort (port) 
Graf Ptr port; 
extern 0xA86F; 

1.10.2 Pascal-Compatible Function Definitions 

A function definition (the actual function), like a function declaration, can also be preceded by the pascal 
specifier. The function then adheres to Pascal-compatible calling conventions and can be called from 
Pascal. For example, the following C function can be called from Pascal: 

pascal void MyText (byteCount , text Addr , numer, denom) 

short byteCount; 

Ptr textAddr; 

Point numer, demon; 
{ 

} 

The corresponding Pascal function declaration would be 

PROCEDURE MyText (bytecount : INTEGER; textAddr: Ptr; numer, denom: Point); 

For compatibility with Pascal and assembly language, the compiler converts the names of Pascal- 
compatible functions to uppercase before writing them to the object file. When they are called in C 
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programs, these routines should be capitalized exactly as they were declared in C. Pascal-compatible 
functions whose names differ only in their capitalization will become duplicate declarations when then- 
names are converted to uppercase by the compiler; therefore such names should be avoided. 



1.10.3 Parameter and Result Types 

C and Pascal support different data types. Therefore when writing a Pascal-compatible function declaration 
in C, a translation of the parameter types and function-result type (from Pascal to C) is required. Often this 
translation is trivial, but other cases are surprising. 

The table below summarizes this translation. Find the Pascal parameter or result type in the first column. 
Use (he equivalent C type found in the second column when declaring the function in C. Comments in the 
table point out unusual cases which may require special attention. 



Comments 

Boolean is defined in file types.h as enum {false,true}. 
In C, false is zero and true is often considered nonzero. 
In Pascal, false is zero and true is one. 



Pascal Parameter or 




Result Type 


C Equivalent 


boolean 


Boolean 


var boolean 


Boolean * 


boolean result 


Boolean 


enumeration 




(<128 or >255 literals) 


enum 


enumeration 




(128 to 255 literals) 


short 


var enumeration 




(<128 or >255 literals) 


enum * 


var enumeration 




(128 to 255 literals) 


short * 


enumeration result 




(<128 or >255 literals) 


enum 


enumeration result 




(128 to 255 literals) 


short 


char 


short 


var char 


char* 


char result 


short 


integer 


short 


var integer 


short * 


short result 


short 


longint 


int or long 


var longint 


int * or long * 


longint result 


int or long 


real 


extended* 


var real 


float * 


real result 


float 


double 


extended * 


var double 


double * 


double result 


double 


comp 


extended * 



Use identical ordering of the enumeration literals. 

Pascal passes enumerations with 128 or more literals as words. 



Surprise! Pascal passes chars as 16-bit values. 

16-bit signed values. 

32-bit signed values. 

Pascal passes real parameters as extended by address. 
Pascal returns real results by value. 
Pascal passes double parameters as extended by address. 
The caller supplies the address of the double result. 
Pascal passes comp parameters as extended by address. 
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var comp 


comp * 


comp result 


comp 


extended 


extended * 


var extended 


extended * 


extended result 


extended 


pointer 


pointer 


var pointer 


pointer * 


pointer result 


pointer 


array (1 or 2 bytes) 


short 


array (3 or 4 bytes) 


int or long 


array (5 or more bytes) 


array 


var array 


array 


array result 




record (1 to 4 bytes) 


struct 


record (5 or more bytes) 


struct * 


var record (any size) 


struct * 


record result (1 or 2 bytes) 


short 


record result (3 or 4 bytes) 


int or long 


record result (1 or 2 bytes) 


struct 


set (1 to 7 elements) 


char 


set (8 to 16 elements) 


short 


set (>17 elements) 


struct 


var set (1 to 7 elements) 


char* 


var set (8 to 16 elements) 


short * 


var set (£17 elements) 


struct * 


set result (1 to 7 elements) 


char 


set result (8 to 16 elements) 


short 


set result (>17 elements) 


struct 



The caller supplies the address of the comp result. 
Pascal passes extended parameters by address. 
The caller supplies the address of the extended result. 
32-bit addresses. 

Pascal passes small arrays by value. 

Pascal passes larger arrays by address. 

C does not allow array results. 

Pascal passes small records by value. 
Pascal passes larger records by address. 

Pascal returns small records by value. 

The caller supplies the address of the record result 

Pascal passes sets with 1 to 7 elements as bytes. 
Pascal passes sets with 8 to 16 elements as words. 
Pascal also passes larger sets by value. 

Pascal returns small sets by value. 

The caller supplies the address of the set result 



2. 



Implementation-Specific Language Details 



A number of details in any language definition are left to the discretion of its individual implementations. 
Most programs do not rely on these details and therefore yield the same results on the various 
implementations. However, knowledge of the major differences between implementations can help avoid 
reliance on language semantics that vary from implementation to implementation. This section explains 
several areas of the language definition that are specific to Workshop C. 



2.1 



Byte Ordering 



On the MC68000, the microprocessor used in the Macintosh, the least significant byte of a short or long 
integer has the highest memory address. This byte ordering is also used on IBM/370 and Z8000 processors. 
The PDP- 1 1 family, VAX, 8086, and NS 16000 use a different ordering. Programs that rely on the order of 
the bytes within words and longs will not work correctly on both classes of machines. 



2.2 



Memory-Allocation Characteristics 



The Workshop C compiler optimizes memory allocation in various ways. Automatic variables (locals) are 
allocated in registers whenever possible:. Static and global variables are not necessarily allocated in the order 
in which they are specified. (However, the order of fields within records is preserved.) Static variables may 
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be allocated as if they were automatic if their values are always set before being referenced. Automatic and 
static variables that are never used may not be allocated at all. Programs should not rely on the compiler's 
allocation algorithms. 

2.3 Unsigned Char and Unsigned Short 

Types unsigned char and unsigned short are supported by the Workshop C compiler and by many 
implementations of PCC, although thejr are not required by the basic C language definition. The VAX 
implementation of PCC and the Workshop C compiler differ in the way they evaluate expressions 
involving these types. For example, the negation operator subtracts an unsigned short from 2 16 under 
PCC (this seems like a bug), and from 2 32 under Workshop C. 

2.4 Bit Fields 

Workshop C provides bit fields that are unsigned, as do all MC68000 versions of PCC of which we are 
aware. However, VAX implementations of C may support signed bit fields. In the following example, 
implementations using unsigned bit fields will set i to 3; implementations using signed bit fields will set i 
to -1. 

struct {int field: 2;} x; 
x. field = 3; 
i = x. field; 

2.5 Evaluation Order 

Workshop C does not define the evaluation order of certain expressions. Expressions with side effects, such 
as function calls and the "++" and " — " operators, may yield different results on different machines or with 
different compilers. Specifically, when a variable is modified as a side effect of an expression's evaluation 
and the variable is also used at another jpoint in the same expression, the value used may be either the value 
before modification or the value after modification. 

Programs that rely on the order of evaluation in these situations are in error. The function call f(i,i++) 
is an example of an expression whose value is undefined. 

2.6 Case Statements 

Some implementations of C, including PCC, allow cases of a switch statement to be nested within 
compound statements. Workshop C considers this an error. The following switch statement compiles 
using PCC but generates an error message using the Workshop C compiler. The error is that case 2: is 
within the if statement. 

switch (i) { 
case 1: 

if (j) < 
case 2 : 
i - 3; 
} 
} 
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3. Implementation Notes 

The definition of C specifies the meaning of C programs. Implementations vary considerably in how they 
choose to implement this definition. Certain implementation details are of interest to assembly language 
programmers who want to write functions that either call or are called from C. This section provides those 

details. 

3.1 C Calling Conventions 

Workshop C uses two different function-calling conventions. This section describes the usual C calling 
Conventions. The Pascal-compatible calling conventions are described in section 3.2. 

3.1.1 Parameters 

Parameters to C functions are evaluated from right to left and are pushed onto the stack in the order they are 
evaluated. Characters, integers, and enumeration types are passed as sign-extended 32-bit values. Pointers 
and arrays are passed as 32-bit addresses. Types float, double, comp, and extended are passed as extended 80- 
bit values. Structures are also passed on the stack. Their size is rounded up to a multiple of 16 bits (2 
bytes). If rounding occurs, the unused storage has the highest memory address. The caller removes the 
parameters from the stack. 

3.1.2 Function Results 

Characters, integers, enumeration types, and pointers are returned as sign-extended 32-bit values in register 
DO. Types float, double, comp, and extended are returned as extended values in registers DO, Dl, and AO. 
The low-order 16 bits of DO contain the sign and exponent bits; register Dl contains the high-order 32 bits 
of the sigriificand; register AO contains the low-order 32 bits of the significand Structure values are 
returned as a 32-bit pointer in register DO. The pointer contains the address of a static variable into which 
the result is copied before returning. This implementation of structure function results is not reentrant 

3.1.3 Register Conventions 

Registers DO, Dl, AO, and Al are scratch registers and are not preserved by C functions. All other registers 
are preserved. Register A5 is the global frame pointer, register A6 is the local frame pointer, and register 
A7 is the stack pointer. Local stack frames are not necessarily created for simple functions. 

3.2 Pascal-Compatible Calling Conventions 

This section describes the conventions used for calling Pascal functions from C and for functions written in 
C that use Pascal-compatible calling conventions. These conventions differ from the usual C calling 
conventions defined in section 3.1; they also differ from the calling conventions used by the Pascal 
compiler. 

3.2.1 Parameters 

Parameters to Pascal-compatible functions are evaluated left to right and are pushed onto the stack in the 
order they are evaluated. Characters and enumeration types whose literal values fall in the range of types 
char or unsigned char are pushed as bytes. (This requires a 16-bit word on the stack. The value is in the 
high-order 8 bits; the low-order 8 bits are unused.) Short ints and enumeration types whose literal values 
fall in the range of types short or unsigned short are passed as 16-bit values. Ints, long ints, and the 
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remaining enumeration types are passed as 32-bit values. Pointers and arrays are passed as 32-bit addresses. 
SANE types float, double, comp, and extended are passed as extended 80-bit values; however this doesn't 
correspond to the Pascal compiler's calling conventions, so a compiler warning is given. The table in 
Section 1.10.3 shows the recommended way to pass SANE-type values to Pascal. Structures are also 
passed by value on the stack, and also yield a compiler warning. Their size is rounded up to a multiple of 
16 bits (2 bytes). If rounding occurs, the unused storage has the highest memory address. The function 
being called removes the parameters from the stack. 

3.2.2 Results 

Function results are returned on the stsick. Stack space for the function result is reserved by the caller prior 
to pushing any parameters. Characters and enumeration types whose literal values fall in the range of types 
char or unsigned char are returned as bytes. (This requires a 16-bit word on the stack. The value is in the 
high-order 8 bits; the low-order 8 bits are unused.) Short ints and enumeration types whose literal values 
fall in the range of types short or unsigned short are returned as 16-bit values. Ints, long into, and the 
remaining enumeration types are returned as 32-bit values. Pointers are returned as 32-bit addresses. Arrays 
may not be returned as function results. Results of type float are returned as 32-^bit values. For structures 
and types double, comp, and extended (he caller pushes the address of a structure, double, comp, or extended 
(respectively) in the function-result loc ation on the stack. The procedure being called stores the result at 
this address. The caller removes the function results from the stack. 

3.2.3 Register Conventions 

Registers DO, Dl, D2, A0, and Al are scratch registers. Scratch registers are not preserved by Pascal- 
compatible functions. All other registm are preserved. Register A5 is the global frame pointer, register 
A6 is the local frame pointer, and register A7 is the stack pointer. 

3.3 Compiler Limitations 

On the Macintosh, the total size of all declared global variables, static variables, and string constants cannot 
exceed 32K bytes. Allocate large global arrays on the heap in order to avoid exceeding this limit 

It is impossible to compile very large functions on the Lisa because the compiler's internal data structures 
cannot fit in memory. As functions approach this limit, compilation time increases noticeably. This 
problem can be alleviated by eliminating unnecessary include files, reducing the number of global 
declarations, compiling large functions separately, and rewriting large functions as two or more smaller 
functions. In addition, renaming Workshop files systemdebug and system.debug2, then rebooting, will 
give the compiler an additional 80K bytes of memory. 

Static functions are not supported in this implementation of C due to limitations in the Lisa Workshop 
object-file definition. Use of static functions may result in this linker message: 

*** Error - Reference to unknown module type. *** 
Static functions can be eliminated by including the define 

#define static 
at the beginning of each compilation or source file. 
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4. Running the Compiler 

The C compiler is named cobj. To run the compiler, use the Lisa Workshop Run command, as shown in 
the example below. Sourcefile names must end with the suffix ".ctext". The ".text" suffix need not be 
specified in response to the input file prompt. The error-listing file is the console by default. The output 
file (object code file) name is by default the source file name, with the ".text" suffix replaced by ".obj". 

Compiler options may be specified by responding to any of the file name prompts by typing a question 
mark (?) and then pressing Return. The compiler will present a partial list of the available options (a 
complete list appears below). Enter the options you want, including minus sign (-) prefixes, on a single 
line separated by spaces. The compiler will then repeat the file name prompt 

The example below compiles the program mac/c/sample/qdsample.c.text, writing the error listing to the 
console and creating the object file nuK/c/sample/qdsample.obj, The -M option is used to direct the code 
to segment sample. Prompts supplied by the Workshop and the compiler are shown in plain text. 
Default file names appear within the prompts in brackets. What you type is printed in boldface. 
"<Return>" means press the Return key. 

r 

Run what program? c <Return> 

C-68/Lisa 1.8.3 Copyright (c) 1984, 1985 Green Hills Software, Inc. 

Name of input file [.TEXT] ? <Return> 

Useful options include: 

-Mname Compile into segment 'name'. 

-Dname Define 'name' with value 1. 

-Dname=string Define 'name' with value 'string'. 

-Uname: Undefine 'name'. 

-Iprefix Add 'prefix' to include-file names. 

-E Write preprocessor output to file preproc.text'. 

-g Generate debug symbols in code. 

Enter options separated by blanks and followed by <Retum> 

Options> -Msample <Return> 

Name of input file [.TEXT] mac/c/sample/qdsamplex <Retnr.n> 

Name of error listing file [-console] / [.TEXT] <Return> 

Name of binary file [ mac/c/saimple/qdsamplex] [.OBJ] <Return> 

4.1 Compiler Options 

The Workshop C compiler recognizes the following options: 

Option Description 

-Mname Name the object-code segment Since a segment may not exceed 32K bytes, large 

programs require multiple segments with different names. The default segment 
name is 8 blanks. 

-Dname Define name to the preprocessor with the value 1. This is equivalent towriting 

#define name 1 at the beginning of the source file 

-Dname-string Define name to the preprocessor with the value "string". This is equivalent to 
writing #define name string at the beginning of the source file. 

-Uname Undefine the predefined preprocessor symbol name. This is equivalent to writing 

#undef name at the beginning of the source file. 



Page 14 



Ex Libris • David T Craig • August 2009 Page 0022 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual 


• Apple Computer Inc. • 1985 






Lisa Workshop C User's Guide 


-Istring 


Include file names that do not start with "-" are searched for with the file name prefix 
"string". Multiple -I options can be specified. They will be searched in the order 
encountered. The include-file search rules are explained in detail in section 4.2. 


-w 


Suppress compiler warning messages. By default, warnings are written to the error 
listing file. 


-E 


Do not compile the program. Instead, write the output of the preprocessor to file 
preproctext This option is useful for debugging preprocessor macros. 


-C 


Include comments with the preprocessor output. By default, comments are not 
written to the preprocessor output. 


-8 


Generate 8-byte function names embedded in the code for the debugger; generate frame 
pointers in A6 (LINK A6,x ... UNLK A6). 


-ga 


Generate stack frame pointers in A6 (LINK A6pt — UNLK A6) for all 
functions. 


-X6 


Use MOVE #0,x instructions rather than CLR x instructions for nonstack 
addresses. This may be useful when writing device drivers. 


-X9 


Disable local (peephole) optimizations. 




-X12 


Generate 68010 code rather than 68000 code 




-Z6 


Always allocate 32 bits for enumerated data types. The default is to allocate 8, 16, or 
32 bits. 


-X55 


Make bit fields of type int, short, and char s 
unsigned. 


igned. The default is to make all fields 


4.2 Include-File Search Rules 




The compiler automatically searches for include files in the mannei 
successfully opened using these rules is included. 


■ described below. The first file 


Tnclude-FileName 


Example 


Search Rules 


Begins with "-" 


#include <-lower-consts.h> 
#include "-lower-consts.h" 


Use the specified name. None of 
the other search rules apply. 


In angle brackets. 


#include <ctype.h> 


Begin the search using the prefix 
"mac/c/include/". Continue the 
search by prefixing the file name 
with strings supplied as -I options. 


In double quotes. 


#include "constants.h" 
Page 15 


Begin the search using the prefix 
(up to the final "/") of the source 
file that contains the include. 
Continue by prefixing the file name 
with strings supplied as -I options. 
Finally, try the include-file name 
without any prefix. 
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5. Files to Link With 

Workshop C programs should be linked using the linker, linker.obj. Programs to be executed on the Macintosh 
must be linked with one or more of the object files listed below. Programs must be linked with the object fitec that 
correspond to the libraries the program uses. 

If no Standard C Library functions are called, link with: 

mac/c/lib/runtime.obj Execution starting point. 

If Standard C Library functions are called, link with one of the following 

mac/c/lib/cruntime.obj Doesn't prompt for argv and argc at the start of execution. 

mac/c/Ub/cruntimeargv.obj Prompts for argv and argc. 

If Standard C Library functions are called, also link with: 

mac/c/lib/stdclib.obj Standard C Library, 

mac/c/lib/stdprintf .obj Standard C Library printf functions, 

mac/c/lib/math.obj Standard C Library math functions. 

If SANE library functions are called or floating-point arithmetic is used, also link with: 

mac/c/lib/sanelib.obj SANE numerics. 

If Macintosh Interface Libraries functions are called, also link with: 

mac/c/lib/interface.obj Macintosh Interface Libraries. 

If Macintosh Interface Libraries printing functions are called, also link with one of the following: 

obj/prlink.obj High-level printing interfaces, 

obj/prscreen.obj Low-level printing interfaces. 
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Standard C Library 



This section describes the Standard C Library provided with Workshop C. After an introductory discussion 
of error-number conventions, the section is arranged alphabetically by function name or category. The 
Library Index is an index of the defines, types, enumeration literals, global variables, and functions defined 
here and in the Macintosh Interface Libraries. 

Remember that identifiers in C are case sensitive and should be spelled exactly as shown in the 
synopsis. Following English usage, we've capitalized the first letter of a lowercase identifier when it 
appears at the beginning of a sentence. 
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NAME 

Introduction to error numbers similar to those in UNIX operating systems. 

SYNOPSIS 

♦include <errno.h> 

extern int errno; 

DESCRIPTION 

Many of the Standard C Library functions have one or more error returns. An error 
condition is indicated by an otherwise impossible returned value. This is almost 
always -1; see descriptions of individual functions for details. An error number is 
also made available in the external variable errno. Errno is not cleared on 
successful calls, so it should be tested only after an error has been indicated. 

The error name appears in brackets following the text in a library function 
description; for example, 

"The next attempt to write a nonzero number of bytes will signal an 
error, [enospc]" 

Not all possible error numbers are listed for each library function because many 
errors are possible for most of the calls. Some UNIX operating system error 
numbers do not apply to Macintosh and are not documented in this manual. 

Here is a list of the error numbers and their names as defined in the <errno.h> file: 

1 [EFERM] Not owner 

Typically this error indicates an attempt to modify a file in a 
way that is not permitted. 

2 [enoent] No such Hie or directory 

This error occurs when a file whose filename is specified 
does not exist or when one of the directories in a pathname 
does not exist. 

5 [EIO] I/O error 

Some physical I/O error has occurred. This error may in 
some cases be signaled on a call following the one to which 
it actually applies. 

6 [ENXIO] No such device or address 

I/O on a special file refers to a subdevice that does not exist, 
or the I/O is beyond the limits of the device. This error may 
also occur when, for example, no disk is present in a drive. 

9 [ebadf] Bad file number 

Either a file descriptor does not refer to an open file, or a 
read (or write) request is made to a file that is open only for 
writing (or reading). 
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12 [ENOMEM] Not enough space 

The system ran out of memory while the library call was 
executing. 

13 [EACCES] Permission denied 

An attempt was made to access a file in a way forbidden by 
the protection system. 

17 [EEXIST] File exists 

An existing file was mentioned in an inappropriate context — 

e.g., open (file, 0_CREAT+OJEXCL) . 

19 [ENODEV] No such device 

An attempt was made to apply an inappropriate system call to 
a device — e.g., read a write-only device. 

20 [EKOTDIR] Not a directory 

An object that is not a directory was specified where a 
directory is required — e.g., in a path prefix. 

21 [EISDIR] Is a directory 

An attempt was made to write on a directory. 

22 [EINVAL]] Invalid argument 

Some invalid argument was provided to a library function. 

23 [ENFILE] File table overflow 

The system's table of open files is full, so temporarily a call 
to open() cannot be accepted. 

24 [EMFILE] Too many open files 

No program may have more than 20 file descriptors open at 
a time. 

28 [ENOSPC] No space left on device 

During a writeO to an ordinary file, there is no free space left 
on the device. 



NOTE 



29 



30 



[ESPIPEJ Illegal seek 

An lseek() was issued incorrectly. 

[EROPS] Read-only file system 

An attempt to modify a file or directory was made on a 
device mounted for read-only access. 



Calls that interface to the Macintosh I/O system — e.g., open(), close(), read(), 
write(), ioctlQ, and others — set the external variable MacOSErr as well as errno. 
This manual documents only errno values. The equivalent Macintosh ROM error- 
return values set in MacOSErr are documented in Inside Macintosh. The 
appropriate include file for most values of MacOSErr is <files.h>. 
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NAME 

abs — return integer absolute value 

SYNOPSIS 

int abs (i) 
irvt i ; 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

NOTE 

The absolute value of the negative integer with largest magnitude is undefined. 

SEE ALSO 

floor () . 



Page 20 



Ex Libris • David T Craig • August 2009 Page 0028 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 
ATOF Standard C Library ATOF 

NAME 

atof — convert ASCII string to floating-point number 

SYNOPSIS 

extended atof (nptr) 
char ~*nptr; 

DESCRIPTION 

Atof converts a character string pointed to by nptr to an extended-precision 
floating-point number. The first unrecognized character ends the conversion. Atof 
recognizes an optional string of white-space characters (blanks or tabs), then an 
optional sign, then a string of digits optionally containing a decimal point, then an 
optional "e" or "E" followed by an optionally signed integer. If the string begins 
with an unrecognized character, aw/returns a NaN. 

DIAGNOSTICS 

Ato/honors the floating-point exception flags — invalid operation, underflow, 
overflow, divide by zero, and inexact — as prescribed by the Standard Apple 
Numeric Environment (SANE). 

SEE ALSO 

scanf(), str2dec(), dec2num{) . 
Apple Numerics Manual. 
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NAME 

atoi — convert string to integer 

SYNOPSIS 

int atoi (str) 
char *str; 

DESCRIPTION 

Atoi returns as an integer the decimal value represented by the character string str. 
The string is scanned up to the first nondigit character other than an optional leading 
minus sign (-). Leading white-space characters (blanks and tabs) are ignored. 

NOTE 

Overflow conditions are ignored. 

SEE ALSO 

atof () , scanf () . 



Page 22 



Ex Libris • David T Craig • August 2009 Page 0030 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 
CLOSE Standard C Library CLOSE 



NAME 

close — close a file descriptor 

SYNOPSIS 

i n t close (fildes) 
int fildes; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat() or open() call. Close closes the 
file descriptor indicated by fildes. 

Close fails if fildes is not a valid open file descriptor, [ebadf] 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is 
returned and errno is set: to indicate the error. 

SEE ALSO 

creatO, open() . 
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NAME 

toupper, tolower, toupper,, tolower, toascii 
— translate characters 

SYNOPSIS 

♦include <ctype.h> 

int toupper (c) 
int c ; 

int tolower (c) 
int c; 

int _toupper (c) 
int c; 

int ^tolower (c) 
int c; 

int toascii (c) 
int c ; 

DESCRIPTION 

Toupper and tolower have as domain the range of getc(): the integers from -1 
through 255. If the argument of toupper represents a lowercase letter, the result is 
the corresponding uppercase letter, ff the argument of tolower represents an 
uppercase letter, the result is the corresponding lowercase letter. All other 
arguments in the domain are returned unchanged. 

Toupper and jolower are macros that accomplish the same thing as toupper 
and tolower but have restricted domains and are faster. Toupper requires a 
lowercase letter as its argument; its result is the corresponding uppercase letter. 
JTolower requires an uppercase letter as its argument; its result is the 
corresponding lowercase letter. Arguments outside the domain cause undefined 
results. 

Toascii yields its argument with all bits turned off that are not part of a standard 
ASCII character; it is intended for compatibility with other systems 

SEE ALSO 

ctype, getc () . 
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NAME 

creat — create a new file or rewrite an existing file 

SYNOPSIS 

lilt creat (path) 
char *path; 

DESCRIPTION 

Cteat creates a new file or prepares to rewrite an existing file named by the 
pathname pointed to by path. If the file exists, the length of its data fork is 
truncated to 0. 

Creat is equivalent to open (path, o_wronly | ojtrunc ) . 

Upon successful completion, a nonnegative integer (the file descriptor) is returned 
and the file is open for writing. The file pointer is set to the beginning of the file. 
A maximum of 20 files may be open at a given time. 

RETURN VALUE 

Upon successful completion, a nonnegative integer (the file descriptor) is returned. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

close (), lseek(), cpen(), read<), write (). 
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NAME 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, 
isgriph, iscntrl, isascii 

— classify characters 

SYNOPSIS 

#include <ctype.h> 

int isalpha (c) 
int c; 



DESCRIPTION 

TheSe macros classify character-coded integer values by table lookup. Each is a 
predicate returning nonzero for true, zero for false. Isascii is defined on all integer 
values; the rest are defined only where isascii is true and on the single non-ASCII 
value EOF (-1). 

isalpha c is a letter. 

isupper c is an uppercase letter. 

islower c is a lowercase letter. 

isdigit c is a digit [0-9]. 

isxdigit c is a hexadecimal digit [0-9], [A-F], or [a-f]. 

isalnum c is alphanumeric (letter or digit). 

isspace c is a space, tab, return, new line, vertical tab, or form feed. 

ispunct c is a punctuation character (neither control nor alphanumeric). 

isprint c is a printing character, code 040 (space) through 0176 (tilde). 

isgraph c is a printing character, similar to isprint except false for space. 

iscntrl c is a delete character (0177) or an ordinary control character (less 

than 040). 

isascii c is an ASCII character, code less than 0200. 

DIAGNOSTICS 

If thb argument to any of these macros is not in the domain of the function, the 
resiilt is undefined. 
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NAME 

ecvt, fcvt — convert floating-point number to string 

SYNOPSIS 

char *ecvt (value, ndigit, decpt, sign) 

extended value; 

int ndigit, * decpt ; *sign; 

char *fcvt (value, ndigit, decpt, sign) 

extended value; 

int ndigit, *decpt, *sign; 

DESCRIPTION 

Ec\!t convert? value to a null-terminated string of ndigit digits and returns a 
pointer to this string as this function result. The low-order digit is rounded. 

The decimal point is not included in the returned string. The position of the decimal 
poiht is indicated by decpt, which indirectly stores the position of the decimal point 
relajtive to the returned string. If the int pointed to by decpt is negative, the decimal 
ponfrt lies to the left of the returned string. For example, if the string is " 12345" and 
decpt points to an int of 3, the value of the string is 123.45; if decpt points to -3, 
the value of the string is .00012345 . 

If the sign of the converted value is negative, the word pointed to by sign is 
nonjzero; otherwise it is zero. 

Fcvt and ecvt provide fixed-point output in the style of Fortran F-format output, 
with the following difference in the interpretation of ndigit. 

In fcvt, ndigit specifies the number of digits to the right of the decimal point. 
In ecvt, ndigit specifies the number of digits in the string. 

NOTE 

The string pointed to by the function result is static data whose content is 
overwritten by each call. 

SEE ALSO 

prihtf(), num2dec(), dec2str. 
Apple Numerics Manual. 
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NAME 

exit, _exit — terminate the current application 

SYNOPSIS 

void exit (status) 

int status ; 

void _exit (status) 

int status; 

DESCRIPTION 

Exit terminates the current application, closing all of the open file descriptors. It 
also causes stdioO cleanup actions before the application terminates. 

The function _exit circumvents all cleanup. 
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NAME 

exp, log, loglO, pow, sqrt 

— exponential, logarithm, power, square-root functions 

SYNOPSIS 

finclude <math.h> 

extended exp(x) 
extended x; 

extended log(x) 
extended x; 

extended loglO (x) 
extended x; 

extended pow(x, y) 
extended x, y; 

extended sqrt (x) 
extended x; 

DESCRIPTION 

Exp returns e x , where e is the natural logarithm base. 

Log returns the natural logarithm (base e) of x. 

LoglO returns the logarithm base ten of x. 

Pow returns x v . 

Sqrt returns the square root of x. 

For special cases, these functions return a NaN or signed infinity as appropriate. 

DIAGNOSTICS 

These functions honor the floating-point exception flags — invalid operation, 
underflow, overflow, divide by zero, and inexact — as prescribed by the Standard 
Apple Numeric Environment (SANE). 

SEE ALSO 

hypot ( ) , s inh ( ) . 

Apple Numerics Manual. 
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NAME 

fclose, fflush — close or flush a stream 

SYNOPSIS 

♦include <stdio.h> 

int fclose (stream) 
FILE *stream; 

int fflush (stream) 

~FILE~*stream; 

DESCRIPTION 

Fclose causes any buffered data for stream to be written out; stream is then 
closed. 

Fclose is performed automatically for all open files upon calling exit(). 

Fflush causes any buffered data for stream to be written out; stream remains 
open. 

DIAGNOSTICS 

These functions return for success or EOF if an error was detected (such as trying 
to write to a file that has not been opened for writing). 

SEE ALSO 

close (), exit(), fopen(), setbuf(). 



Page 30 



Ex Libris • David T Craig • August 2009 Page 0038 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 
FERROR Standard C Library FERROR 

NAME 

ferror, feof , clearerr, fileno — stream status inquiries 

SYNOPSIS 

♦include <stdio.h> 

int feof (stream) 

"PILE *stream; 

int ferror (stream) 
FILE *stream; 

void clearerr (stream) 
FILE * stream; 

int fileno (stream) 
FILE ~*stream; 

DESCRIPTION 

Feof returns nonzero when end-of-file has previously been detected reading the 
named input stream; otherwise, it returns zero. 

Ferror returns nonzero when an I/O error has previously occurred reading from or 
writing to the named stream; otherwise, it returns zero. 

Clearerr resets the error indicator and end-of-file indicator to zero on the named 
stream. 

Fileno returns the integer file descriptor associated with the named stream; see 
open(). 

NOTE 

All these functions are implemented as macros; they cannot be declared or 
redeclared. 

SEE ALSO 

open ( ) , f open ( ) . 
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NAME 

floor, ceil, fmod, fabs — floor, ceiling, mod, absolute value functions 

SYNOPSIS 

♦include <math.h> 

extended floor (x) 
extended x; 

extended ceil(x) 
extended x; 

extended fmod(x, y) 
extended x, y; 

extended fabs (x) 
extended x; 

DESCRIPTION 

Floor returns the largest integer (as an extended-precision number) not greater than 
x. 

Ceil returns the smallest integer not less than x. 

Whenever possible, fmod returns the number f with the same sign as x, such that 
x = iy + f for some integer i, and |f| < fy|. Ify is zero, fmod returns a NaN. 

Fabs returns |x|. 

SEE ALSO 

abs<), rintf), setround<) . 
Apple Numerics Manual. 
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NAME 

fopen, freopen, fdopen — open a stream 

SYNOPSIS 

♦include <stdio.h> 

FILE. *f open (filename, type) 
char *filename, *type; 

FILE *freopen (filename, type, stream) 
char * filename, *type; 
FILE *stream; 

FILE *fdopen (fildes, type) 
int fildes; 
char *type; 

DESCRIPTION 

Fopen opens the file named by filename and associates a stream with it. Fopen 
returns a pointer to the FILE structure associated with the stream. 

Filename points to a character string that contains the name of the file to be 
opened. 

Tyve is a character string having one of the following values: 

r open for reading 

w truncate orlcreate for writing 

a append: open for writing at end-of-file, or create for writing. 

r+ open for update (reading and writing}. 

w + truncate or create for update 

a+ append: open or create for update at end-of-file 

Freopen substitutes the nalmed file for the open stream The original stream is 
closed, regardless of whether the open ultimately succeeds. Freopen returns a 
pointer to the FILE structure associated with stream, 

Freopen is typically used to attach the previously opened streams associated with 
stdin, stdout. and stderr'to other files. 

Fdopen associates a streari;,withi sfile> descriptor by formatting a file structure 
from the file descriptor. Thub, fdopen can be used to access the file descriptors 
returned by openQ or creatQ. (These calls open files but do not return pointers to a 
FILE structured The type of stream must agree with the mode of the open file 

When a file is opened for ihpdate, both input and output may be done on the 
resulting stream. However, output may not be directly followed by input without 
an intervening fseekQ or rewindQ, and input may not be directlv followed by 
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output without an intervening fseek(), rewindO, or an input operation that 
encounters end-of-file. 

When a file is opened for append (i.e., when type is "a" or "a+"), it is impossible 
to overwrite information already in the file. Fseek() may be used to reposition the 
file pointer to any position in the file, but when output is written to the file the 
current file pointer is disregarded. All output is written at the end of the file and 
causes the file pointer to be repositioned at the end of the output. 

DIAGNOSTICS 

Fopen andfreopen return a null pointer on failure. 

SEE ALSO 

open() , fcloseO . 
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NAME 

fread, fwrite — binary input/output 

SYNOPSIS 

♦include <stdio.h> 

int fread(ptr, size, nitems, stream) 

char *ptr; 

int size, nitems; 

FILE *stream; 

int fwrite (ptr, size, nitems, stream) 

char *ptr; 

int size, nitems ; 

FILE *stream; 

DESCRIPTION 

Fread copies nitems items of data from the named input stream into an array 
beginning at ptr. An item of data is a sequence of bytes (not necessarily terminated 
by a null byte) of length size. Fread stops appending bytes if an end-of-file or 
error condition is encountered while reading stream or if nitems items have been 
read. Fread leaves the file pointer in stream, if defined, pointing to the byte 
following the last byte read if there is one. Fread does not change the contents of 
stream. 

Fwrite appends at most nitems items of data to the named output stream from the 
array pointed to by ptr. Fwrite stops appending when it has appended nitems 
items of data or if an error condition is encountered on stream. Fwrite does not 
change the contents of the array pointed to by ptr. 

The variable size is typically sizeof { *ptr) where the pseudo-function sizeof 
specifies the length of an item pointed to by ptr. If ptr points to a data type other 
than char it should be cast into a pointer to char. 

DIAGNOSTICS 

Fread and fwrite return the number of items read or written. If nitems is zero or 
negative, no characters are read or written and zero is returned by both fread and 
fwrite. 



fopenf), getcO, getsO, printfO, putc<), putsO, read(), 
scanf(), stdio(), write (). 
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NAME 

frexp, ldexp, modf — manipulate parts of floating-point numbers 

SYNOPSIS 

extended frexp (value, eptr) 
extended value; 
int *eptr; 

extended ldexp (value, exp) 
extended value; 
int exp ; 

extended modf (value, iptr) 
extended value, *iptr; 

DESCRIPTION 

Every nonzero number can be written uniquely as x* 2 n , where the mantissa 
(fraction) x is in the range 0.5 < |x| < 1.0, and the exponent n is an integer. Frexp 
returns the mantissa of an extended value and stores the exponent indirectly in the 
location pointed to by eptr. Note that the mantissa here differs from the significand 
described in the Apple Numerics Manual* whose normal values are in the range 
1.0 <; |x| < 2.0 . 

Ldexp returns the quantity value* 2 ex P. 

Modf returns the signed fractional part of value and stores the integral part 
indirectly in the location pointed to by iptr. 

DIAGNOSTICS 

Ldexp honors the floating-point exception flags — invalid operation, underflow, 
overflow, divide by zero, and inexact — as prescribed by the Standard Apple 
Numeric Environment (SANE). 

SEE ALSO 

logb() , scalb() . 

Apple Numerics Manual. 
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NAME 

fseek, rewind, ftell — reposition a file pointer in a stream 

SYNOPSIS 

tinclude <stdio.h> 

int fseek (stream, offset, ptrname) 
FILE *stream; 
long offset; 
int ptrname; 

void rewind (stream) 
FILE *stream; 

long ftell (stream) 
FILE *stream; 

DESCRIPTION 

Fseek sets the position of the next input or output operation on the stream. The 
new position is at the signed distance offset bytes from the beginning, the current 
position, or the end of the file, when the value of ptrname is 0, 1, or 2, 
respectively. 

Rewind (stream) is equivalent to fseek(stream, ol, 0) except that no value is 
returned. 

Fseek and rewind undo any effects of ungetc(). 

After fseek or rewind, the next operation on a file opened for update may be 
either input or output. 

Ftell returns the offset of the current byte relative to the beginning of the file 
associated with the named stream. 

DIAGNOSTICS 

Fseek returns nonzero for improper seeks; otherwise it returns 0. An improper 
seek can be, for example, an fseek done on a file that has not been opened via 
fopen(). 

SEE ALSO 

lseek() , fopen() . 
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NAME 

getc, getchar, fgetc, getw — get character or word from stream 

SYNOPSIS 

♦include <stdio.h> 

int getc (stream) 
FILE *stream; 

int getchar () 

int fgetc (stream) 
FILE *stream; 

int getw (stream) 
FILE *stream,- 

DESCRIPTION 

Getc returns the next character (i.e., byte) from the named input stream. It also 
moves the file pointer, if defined, ahead one character in stream. Getc is a macro 
and therefore cannot be used if a function is necessary; for example, you cannot 
have a function pointer point to it. 

Getchar returns the next character from the standard input stream, stdin. Like 
getc, getchar is a macro. 

Fgetc behaves lik&getc but is a function. Fgetc runs more slowly than getc but 
takes less space per invocation. 

Getw returns the next "word" (i.e., four bytes) from the named input stream so 
that the order of bytes in the stream corresponds to the order of byes in memory. 
Getw returns the constant EOF upon end-of-file or error. Since EOF is a valid 
integer value, feof() and ferror() should be used to check the success of getw. 
Getw increments the associated file pointer, if defined, to point to the next word. 
Getw assumes no special alignment in the file. 

DIAGNOSTICS 

These functions return the integer constant EOF at end-of-file or upon an error. 

NOTE 

Because it is implemented as a macro, getc treats incorrectly a stream argument 
with side effects. In particular, getc(*f++) doesn't work as you would expect. 
Use fgetc (*f++) instead. 

SEE ALSO 

fcloseO, ferrorO, fopen(), freadO, gets(), putcO, scanf(), 
stdioQ . 
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NAME 

gets, fgets — get a string from a stream 

SYNOPSIS 

♦include <stdio.h> 

char *gets(s) 
char *s; 

char *fgets(s, n, stream) 

char *s; 

int n; 

FILE *stream; 

DESCRIPTION 

Gets reads characters from the standard input stream, stdin, into the array pointed 
to by s, until a newline character is read or an end-of-file condition is encountered. 
The newline character is discarded and the string is terminated with a null character. 

Fgets reads characters from the stream into the array pointed to by s until n-1 
characters are read, or a newline character is read and transferred to s, or an end-of- 
file condition is encountered. The string is then terminated with a null character. 

DIAGNOSTICS 

If end-of-file is encountered and no characters have been read, no characters are 
transferred to s and a null pointer is returned. If a read error occurs, a null pointer 
is returned. Otherwise * is returned. (A read error will occur, for example, if you 
attempt to use these functions on a file that has not been opened for reading.) 

SEE ALSO 

ferrorO, fopen(), freadO, getc(), scanf(), stdio(). 
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NAME 

hypot — Euclidean distance function 

SYNOPSIS 

#include <math.h> 

extended hypot (x, y) 
extended x, y; 

DESCRIPTION 

Hypot returns 

sqrt (x * x + y * y) 

taking precautions against unwarranted overflows. 

DIAGNOSTICS 

Hypot honors the floating-point exception flags-— invalid Operation, underflow, 
overflow, divide by zero, and inexact— as prescribed by the Standard Apple 
Numeric Environment (SANE). 

i r»/-\ 

sqrt () . 

Apple Numerics Manual. 
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NAME 

lseek — move read/write file pointer 

SYNOPSIS 

long lseek (fildes, offset, whence) 
int f ildes ; 
long offset; 
int whence ; 

DESCRIPTION 

Fildes is a file descriptor returned from a creat() or open() call. Lseek sets the file 
pointer associated with fildes as follows: 

If whence is 0, the pointer is set to offset bytes 

If whence is 1, the pointer is set to its current location plus offset. 

If whence is 2, the pointer is set to the size of the file plus offset. 

Upon successful completion, the resulting pointer location as measured in bytes 
from the beginning of the file is returned. 

Lseek fails and the file pointer remains unchanged if one or more of the following 
are true: 

Fildes is not an open file descriptor, [ebadf] 

Whence is not 0, 1, or 2. [einval ] 

The resulting file pointer would be negative, [einval ] 

Some devices are incapable of seeking. The value of the file pointer associated with 
such a device is undefined. 

RETURN VALUE 

Upon successful completion, a nonnegative integer indicating the file pointer value 
is returned. Otherwise, a value of -1 is returned and errno is set to indicate the 
error. 

NOTE 

In previous versions of the Standard C Library, tell <f iledes) was a function that 
returned the current file position. It is equivalent to the call lseek < fildes , ol, l) . 

SEE ALSO 

creat ( ) / open ( ) . 
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NAME 

malloc, free, realloc, calloc — main memory allocator 

SYNOPSIS 

char *malloc (size) 
unsigned size; 

void free (ptr) 
char *ptr; 

char *realloc (ptr, size) 

char *ptr; 
unsigned size; 

char *calloc (nelem, elsize) 
unsigned nelem, elsize; 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package. 
The memory that is allocated for a program's use is known as the "storage arena." 
The storage arena expands as malloc is called. 

Malloc returns a pointer to a block of at least size bytes suitably aligned for any 
use. The argument to free is a pointer to a block previously allocated by malloc; 
after free is performed this space is made available for further allocation. 

Undefined results occur if the space assigned by malloc v& overrun or if some 
random value is handed to free. 

Malloc allocates the first sufficiendy large contiguous reach of free space it finds. 
It calls NewPointer() to get more memory from the system when there is no suitable 
space already free. 

Realloc changes the size of the block pointed to by ptr to size bytes and returns a 
pointer to the (possibly moved) block. The contents are unchanged up to the lesser 
of the new and old sizes. If no free block of size bytes is available in the storage 
arena, realloc asks malloc to enlarge the storage arena by size bytes and then 
moves the data to the new space. 

Calloc allocates space for an array of nelem elements of size elsize. The space is 
initialized to zeros. 

DIAGNOSTICS 

Malloc, realloc, and calloc return a null pointer if there is no available memory 
or if the storage arena has been detectably corrupted by storing outside the bounds 
of a block. When this happens the block pointed to by ptr may have been 
destroyed. 
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NAME 

raemccpy, memchr, memcmp, memcpy, memset — memory operations 

SYNOPSIS 

char *memccpy (si, s2, c, n) 
char *sl, *s2; 
int c, n; 

char *memchr(s, c, n) 
char *s; 
int c, n; 

int memcmp (si, s2, n) 
char *sl, *s2; 
int n ; 

char *memcpy(sl, s2, n) 
char *sl, *s2; 
int n ; 

char *memset (s, c, n) 
char *s; 
int c, n; 

DESCRIPTION 

These functions operate efficiently on memory areas (arrays of characters bounded 
by a count, not terminated by a null character). They do not check for the overflow 
of any receiving memory area. 

Memccpy copies characters from memory area s2 into si, stopping after the first 
occurrence of character c has been copied or after n characters have been copied, 
whichever comes first. It returns either a pointer to the character after the copy of c 
in si or a null pointer if c was not found in the first n characters of s2. 

Memchr returns either a pointer to the first occurrence of character c in the first n 
characters of memory area s or a null pointer if c does not occur. 

Memcmp compares its arguments, looking at the first n characters only. It returns 
an integer less than, equal to, or greater than 0, depending on whether si is less 
than, equal to, or greater than s2 in the ASCII collating sequence. 

Memcpy copies n characters from memory area s2 to si. It returns si. 

Memset sets the first n characters in memory area s to the value of character c. It 
returns s. 

NOTE 

Overlapping moves may yield unexpected results. 
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NAME 

open — open for reading or writing 

SYNOPSIS 

♦include <fcntl.h> 

int open (path, of lag) 
char *path; 
int oflag; 

DESCRIPTION 

Path points to a pathname naming a file. Open opens a file descriptor for the 
named file and sets the file status flags according to the value of oflag. Oflag 
values are constructed by or-ing flags from the following list (only one of the first 
three flags below may be used): 

ORDONLY Open for reading only. 

QWRQNLY Open for writing only. 

0_RDWR Open for reading and writing. 

0_APPEND If set, the file pointer is set to the end of the file prior to 
each write. 

0_CREAT If the file does not exist, it is created. 

O TRUNC If the file exists, its length is truncated to 0; the mode and 

owner are unchanged. 

0_EXCL If 0_EXCL and 0_CREAT are set, openfails if the file 

exists. 

Upon successful completion a nonnegative integer, the file descriptor, is returned. 
No application may have more than 20 file descriptors open simultaneously. The 
file pointer used to mark the current position within the file is set to the beginning of 

the file. 

The named file is opened unless one or more of the following are true: 

OCREAT is not set and the named file does not exist, [enoent] 

20 file descriptors are currently open, [emfile] 

OCREAT and OJ3XCL are set and the named file exists, [eexist] 

RETURN VALUE 

Upon successful completion, a nonnegative integer (the file descriptor) is returned; 
otherwise, a value of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

close (), creatO, lseek(), read(), write (). 
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NAME 

printf, fprintf, sprintf— print formatted output 

SYNOPSIS 

♦include <stdio.h> 

int printf (format [ , arg ] "... ) 
char * format; 

int fprintf (stream, format [ , arg ] ... ) 
FILE *stream; 
char * format; 

int sprintf (str, format [ , arg ] ... ) 
char *str, format; 

DESCRIPTION 

Printf places formatted output on the standard output stream stdout. Fprintf 
places formatted output on the named output stream. Sprintf places formatted 
output, followed by the null character (\0), into the character array pointed to by 
str; it's your responsibility to ensure that enough storage is available. Each 
function returns the number of characters transmitted (not including the \0 in the 
case of sprintf), or a negative value if an output error was encountered. 

Each of these functions converts, formats, and prints its args under control of the 
format. The format is a character string that contains two types of objects: plain 
characters, which are simply copied to the output stream, and conversion 
specifications, each of which results in fetching zero or more args. The results are 
undefined if there are insufficient args for the format. If the format is exhausted 
while args remain, the extra args are ignored. 

Each conversion specification is introduced by the character %. After %, the 
following appear in sequence: 

• Zero or more flag characters, which modify the meaning of the conversion 
specification. 

• An optional decimal digit string specifying a minimum field width. If the 
converted value has fewer characters than the field width, it will be padded 
to the field width on the left (default) or right (if the left-adjustment flag has 
been given); see below for flag specification. 

• A precision that gives the minimum number of digits to appear for the d, o, 
u, x, or X conversions, the number of digits to appear after the decimal 
point for the e, E, and f conversions, the maximum number of significant 
digits for the g and G conversions, or the maximum number of characters 
to be printed from a string in s conversion. The format of the precision is a 
period (.) followed by a decimal digit string; a null digit string is treated as 
zero. 

• An optional 1 specifying that a following d, o, u, x, or X conversion 
character applies to a long-integer arg. The 1 option is ignored in this 
implementation since integers and long integers both require 32 bits. 
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• A character that indicates the type of conversion to be applied. 

A field width or precision may be indicated by an asterisk (*) instead of a digit 
string. In this case, an integer arg supplies the field width or precision. The arg 
that is actually converted is not fetched until the conversion letter is seen; therefore, 
the args specifying field width or precision must appear immediately before the arg 
(if any) to be converted. 

The flag characters and their meanings are: 

- The result of the conversion will be left-justified within the field. 

+ The result of a signed conversion always begins with a sign 

(+ or -). 

blank If the first character of a signed conversion is not a sign, a blank will 

be prefixed to the result. This implies that if the blank and + flags 
both appear, the blank flag Will be ignored. 

# This flag specifies that the value is to be converted to an "alternate 

form." For c, d, s, and u conversions, the flag has no effect. For 
o conversion, it increases the precision to force the first digit of the 
result to be a zero. For x (X) conversion, a nonzero result will have 
"Ox" ("OX") prefixed to it. For e, E, f, g, and G conversions, the 
result will always contain a decimal point, even if no digits follow 
the point (Normally, a decimal point appears in the result of these 
conversions only if a digit follows it.) For g and G conversions, 
trailing zeros in the fractional part will not be removed from the 
result (as they normally are). 

The conversion characters and their meanings are: 

d,o,u,x,X The integer arg is converted to signed decimal (d), unsigned octal 
(o), decimal (u), or hexadecimal notation (x and X), respectively; 
the letters "abcdef ' are used for x conversion and the letters 
"ABCDEF 1 for X conversion. The precision specifies the minimum 
number of digits to appear; if the value being converted can be 
represented in fewer digits, it will be expanded with leading zeros. 
The default precision is 1. The result of converting a zero value 
with a precision of zero is a null string. 

f The float, double, comp, or extended arg is converted to decimal 

notation in the style "[-]ddd.ddd", where the number of digits after 
the decimal point is equal to the precision specification. If the 
precision is missing, it is assumed to be 6; if the precision is 
explicitly 0, no decimal point appears. Infinities are printed as 
"[-]INF" and NaNs are printed as "[-]NAN(ddd)" where ddd is a 
code indicating why the result is not a number. 

e,E The float, double, comp, or extended arg is converted in the style 

"[-]d.ddde±dd", where mere is one digit before the decimal point 
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g,G 



c 
s 



% 



EXAMPLES 



and the number of digits after it is equal to the precision; when the 
precision is missing, it is assumed to be 6; if the precision is zero, 
no decimal point appears. The E format code produces a number 
with "E" instead of "e" introducing the exponent. The exponent 
always contains at least two digits. Infinities are printed as "INF" 
and NaNs are printed as "[-]NAN(ddd)", where ddd is a code 
indicating why the result is not a number. 

The float, double, comp, or extended arg is printed in style f or e 
(or in style E in the case of a G format code), with the precision 
specifying the number of significant digits. The style used depends 
on the value converted: style e is used only if the exponent resulting 
from the conversion is less than -4 or greater than the precision. 
Trailing zeros are removed from the result. A decimal point appears 
only if it is followed by a digit. 

The character arg is printed. 

The arg is taken to be a string (character pointer) and characters from 
the string are printed until a NULL character (\0) is encountered or 
the number of characters indicated by the precision specification is 
reached If the precision is missing, it is taken to be infinite, so all 
characters up to the first null character are printed. If the string 
pointer arg has the value zero, the result is undefined. A null arg 
yields undefined results. 

Print a %; no argument is converted. In no case does a nonexistent 
or small field width cause truncation of a field; if the result of a 
conversion is wider than the field width, the field is simply 
expanded to contain the conversion result. Characters generated by 
printf and fprintf are printed as if putcQ had been called. 



To print a date and time in the form "Sunday, July 3, 10:02", where weekday and 
month are pointers to null-terminated strings: 

printf ("%s, %s %d, %.2d:%.2d" f weekday, month, day, hour, min) ; 

To print pi to 5 decimal places: 

printf ("pi = %.5f", pi()); 

SEE ALSO 

dec2str, ecvtO, num2dec(), putcO, scanf(), stdioO. 
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NAME 

putc, putchar, fputc, putw — put character or word on a stream 

SYNOPSIS 

♦include <stdio.h> 

int putc(c, stream) 
char c; 

FILE *stream; 

int putchar (c) 
char c; 

int fputc (c, stream) 

char c; 

FILE * stream; 

int putw(w, stream) 

int w; 

FILE *stream; 

DESCRIPTION 

Putc writes the character c to the output stream at the position pointed to by the file 
pointer, if one is defined. Putchar <c) is equivalent to putc {c, stdout) . Putc 
and putchar are macros. 

Fputc behaves Wk&putc but is a function rather than a macro. Fputc runs more 
slowly than putc but takes less space per invocation. 

Putw writes the "word" w (i.e., four bytes) to the output stream at the position 
pointed to by the file pointer, if one is defined. Putw neither assumes nor causes 
special alignment in the file. 

Output streams, with the exception of the standard error stream stderr, are by 
default buffered if the output refers to a file and line-buffered if the output refers to 
a window. Stderr is by default unbuffered, but use of freopen() causes it to 
become buffered or line-buffered. When an output stream is unbuffered 
information, it is queued for writing on the destination file or window as soon as 
written; when it is buffered, many characters are saved up and written as a block; 
when it is line-buffered, each line of output is queued for writing on the destination 
window as soon as the line is completed (i.e., as soon as a newline character is 
written or terminal input is requested). Setbuf() may be used to change the stream's 
buffering strategy. 

DIAGNOSTICS 

On success, these functions each return the value they have written. On failure, 
they return the constant EOF. This occurs if the file stream is not open for writing 
or if the output file cannot be grown. Because EOF is a valid integer, ferrorQ 
should be used to detect putw errors. 

NOTE 

Because it is implemented as a macro, putc treats incorrectly a stream argument 
with side effects. In particular, putc(c, *f++) ; doesn't work as you would 
expect. Fputc should be used instead. 
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SEEAL ?c°iose<), ferrorO, fopenO, freadO, getcO, printfO, putaO, 
setbuf ( ) , stdio ( ) - 
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NAME 

puts, fputs — write a string to a stream 

SYNOPSIS 

♦include <stdio . h> 

int puts (s) 
char *s; 

int fputs (s, stream) 
char *s; 
FILE *stream; 

DESCRIPTION 

Puts writes the nuU-terminated string pointed to by s, followed by a newline 
character, to the standard output stream stdout. 

Fputs writes the null-terminated string pointed to by s to the named output stream. 

Neither function writes the tenninating null character. 

DIAGNOSTICS 

Both routines return EOF on error. This occurs if the routines try to write on a file 
that has not been opened for writing. 

NOTE 

Puts appends a newline character while fputs does not. 

SEE ALSO 

ferrorO, fopen(), fread<), printf(), putc(), stdio(). 
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NAME 

rand, srand — simple random-number generator 

SYNOPSIS 

int rand ( ) 

void srand (seed) 
unsigned seed; 

DESCRIPTION 

Rand uses a multiplicative congruential random-number generator with period 2 32 
that returns successive pseudorandom numbers in the range from to 2 15 -1. 

Srand can be called at any time to reset the random-number generator to a specific 
seed. The generator is initially seeded with a value of 1. 

SEE ALSO 

randomx() . 
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NAME 

read — read from file 

SYNOPSIS 

int read(f ildes, buf, nbyte) 

int fildes ; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creatQ or openQ call. 

Read attempts to read nbyte bytes from the file associated with fi Ides into the 
buffer pointed to by huf. 

On devices capable of seeking, the read starts at a position in the file given by the 
file pointer associated with fildes. Upon return from read, the file pointer is 
incremented by the number of bytes actually read. 

Nonseeking devices always read from the current position. The value of a file 
pointer associated with such a file is undefined. 

Upon successful completion, read returns the number of bytes actually read and 
placed in the buffer; this number may be less than nbyte if the file is associated 
with a window or if the number of bytes left in the file is less than nbyte bytes. A 
value of is returned when an end-of-file has been reached. 

Read fails if fildes is not a valid file descriptor open for reading, [ebadf] 

RETURN VALUE 

Upon successful completion a nonnegative integer is returned indicating the number 
of bytes actually read. Otherwise, -1 is returned and errno is set to indicate the 
error. 

SEE ALSO 

creat ( ) , open ( ) , stdio ( ) . 
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NAME 

scanf, fscanf, sscanf — convert formatted input 

SYNOPSIS 

♦include <stdio.h> 

int scanf (format [ , pointer ] ... ) 
char *format; 

int fscanf (stream, format [ , pointer ] ... ) 
FILE *stream; 
char *format; 

int sscanf (s, format [ , pointer ] ... ) 
char *s, *format; 

DESCRIPTION 

Scanf reads characters from the standard input stream stdin. Fscanf reads 
characters from the named input stream, stream. Sscanf reads characters from the 
character string s. Each function converts the input according to a control string 
(format) and stores the results according to a set of pointer arguments that indicate 
where the converted output should be stored. 

Format, the control string, contains specifications that control the interpretation of 
input sequences. The control string consists of characters to be matched in the input 
stream and/or conversion specifications that start with %. The control string may 
contain: 

• White-space characters (blanks and tabs) that cause input to be read up to 
the next non- white-space character, except as described below. 

♦ A character (any except %) that must match the next character of the input 
stream. To match a % character in the input stream, use "%%". 

* Conversion specifications beginning with the character % and followed by 
an optional assignment suppression character *, an optional numeric 
maximum field width, an optional 1, m, n, or h indicating the size of the 
receiving variable, and a conversion code. 

An input field is defined relative to its conversion specification. The input field ends 
when the first character inappropriate for conversion is encountered or when the 
specified field width is exhausted. After conversion, the input pointer points to the 
inappropriate character. 

A conversion specification directs the conversion of the next input field; the result is 
placed in the variable pointed to by the corresponding argument, which is a pointer to 
a basic C type such as int or float. 

Assignment can be suppressed by preceding a format character with a *. 
Assignment suppression causes an input field to be skipped; the field is read and 
converted but not assigned. Therefore pointer should be omitted when assignment 
of the corresponding input field is suppressed. 
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The format character dictates the interpretation of the input field The following 
format characters are legal in a conversion specification, after %: 


% 


A single % is expected in the input at this point; no assignment is done. 




The conversion characters d,u,o, and x may be 
preceded by I or h to indicate that a pointer to long 
or short, rather than int, is in the argument list. The 
I is ignored in this implementation because ints and 
longints are both 32 bits. 


d 


A decimal integer is expected; the corresponding argument should be an 
integer pointer. 


u 


An unsigned decimal integer is expected; the corresponding argument 
should be an unsigned integer pointer. 





An octal integer is expected; the corresponding argument should be an 
integer pointer. 


X 


A hexadecimal integer is expected; the corresponding argument should 
be an integer pointer. 




The conversion characters e,f, and g may be 
preceded by l,m, or n to indicate that a pointer to 
double, comp, or extended, rather than float, is in 
the argument list. 


e,f,g 


A floating-point number is expected; the next field is converted 
accordingly and stored through the corresponding argument, which 
should be a pointer to a float, double, comp, or extended, depending on 
the size specification. The input format for floating-point numbers is an 
optionally signed string of digits, possibly containing a decimal point, 
followed by an optional exponent field consisting of "E" or "e" followed 
by an optionally signed integer. In addition, infinity is represented by 
the string "INF', and NaNs are represented by the string "NAN", 
optionally followed by parentheses which may contain a string of digits 
(the NaN code). Case is ignored in the infinity and NaN strings. 


s 


A character string is expected; the corresponding argument should be a 
character pointer to an array of characters large enough to accept the 
string; a terminating null character (\0) is added automatically. The input 
field is terminated by a white-space (blank or tab) character. 


c 


A character is expected; the corresponding argument should be a 
character pointer. The normal skip over white space is suppressed in 
this case; to read the next non-white-space character, use "%ls". If a 
field width is given, the corresponding argument should refer to a 
character array; the indicated number of characters is read. 


[ 


The left bracket introduces a scanset format The input field is the 
maximal sequence of input characters consisting entirely of characters in 
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the scanset. When reading the input field, string data and the normal 
skip over leading white space are suppressed. The corresponding 
pointer argument must point to a character array large enough to hold the 
input field and the terminating null character (\0), which will be added 
automatically. The left bracket is followed by a set of characters (the 
scanset) and a terminating right bracket. 

l tie circumflex ( " ), when it appears as the first 
character in the scanset, serves as a complement 
operator and redefines the scanset as the set of all 
characters not contained in the remainder of the 
scanset string. 

The right bracket (J) ends the scanset. To include 
the right bracket as an element of the scanset, it must 
appear as the first character (possibly preceded by a 
circumflex) of the scanset; otherwise it will be 
interpreted syntactically as the closing bracket. 

A range of characters may be represented by the construct first- last, 
thus the scanset [0123456789] may be expressed [0-9]. To use this 
convention, first must be less than or equal to last in the ASCII 
collating sequence; otherwise the minus (-) will stand for itself in the 
scanset. The minus will also stand for itself whenever it is the first or 
the last character in the scanset. 

Scan/conversion terminates at EOF, at the end of the control string, or when an 
input character doesn't match the control string. In the latter case, the unmatched 
character is left unread in the input stream. 

Scanf returns the number of successfully matched and assigned input items; this 
number can be zero when an early mismatch between an input character and the 
control string occurs. If the input ends before the first mismatch or conversion, EOF 
is returned. 

EXAMPLES 

Example 1. The call 

int i; float x; char name[50]; 
scanf <"%d%f%s", &i, &x, name); 

with input 

25 54.32E-1 hartwell 

will assign the value 25 to i, and the value 5.432 to x; name will contain 
"hartwell\0". 

Example 2. The call 

int i; extended x; char name [50] ; 

scanf ("%2d%nf%*d% [0-9]", &i, &x, name); 
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with input 

56789 0123 56a72 

will assign 56 to i, 789.0 to x, skip 0123, and place the string "56\0" in name. The 
next call to getchar() will return "a". 

Example 3. The call 

int i ; 

scanf ("answerl=%d", &i) ; 

with input 

answerl=51 answer2=45 

will assign the value 51 to i since "answerl" is matched explicitly in the input stream; 
the input pointer will be left at the space before "answer2". 

DIAGNOSTICS 

These functions return EOF on end of input and a short count for missing or illegal 
data items. 

NOTE 

Trailing white space is left unread unless matched in the control string. 

The success of literal matches and suppressed assignments is not directly 
determinable. 

SEE ALSO 

atof , dec2num(), getc<), 
Apple Numerics Manual. 
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NAME 

setbuf — assign buffering to a stream 

SYNOPSIS 

#include <stdio.h> 

void setbuf (stream, buf) 
FILE *stream; 
char *buf; 

DESCRIPTION 

Setbuf is used after a stream has been opened but before it is read or written. 
Setbuf causes the character array pointed to by buf to be used instead of an 
automatically allocated buffer. If buf is a null character pointer, input/output will 
be completely unbuffered. 

BUFSIZ, a constant defined in the <stdio.h> header file, indicates how big an array 
is needed: 

char buf [BUFSIZ]; 

A buffer is normally obtained from malloc() at the time of the first getc() or pute() 
on the file, except that the standard error stream stderr is normally not buffered. 

Output streams directed to windows are either line-buffered or unbuffered. 

NOTE 

A common error is to allocate buffer space as an "automatic" variable in a code 
block and then fail to close the stream in the same block. 

SEE ALSO 

fopen(), getc(), mallocO, putc(). 
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NAME 

sinh, cosh, tanh — hyperbolic functions 

SYNOPSIS 

♦include <math.h> 

extended sinh (x) 
extended x; 

extended cosh (x) 
extended x; 

extended tanh (x) 
extended x; 

DESCRIPTION 

Sinh, cosh, and tanh return, respectively, the hyberbolic sine, cosine, and 
tangent of their argument. 

DIAGNOSTICS 

Sinh, cosh, and tanh honor the floating-point exception flags — invalid 
operation, underflow, overflow, divide by zero, and inexact—as prescribed by the 
Standard Apple Numeric Environment (SANE). 

SEE ALSO 

Apple Numerics Manual. 



Page 58 



Ex Libris • David T Craig • August 2009 Page 0066 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 
STDIO Standard C Library STDIO 

NAME 

stdio — standard buffered input/output package 

SYNOPSIS 

♦include <stdio.h> 

FILE *stdin, *stdout, *stderr; 

DESCRIPTION 

The standard I/O package constitutes an efficient user-level I/O buffering scheme. 
The inline macros gete() and putc() handle characters quickly. The macros 
getchar() and putchar(), and the higher-level routines fgetc(), fgets(), fprintf(), 
fputc(), fputs(), fread(), fscanf(), fwrite(), gets(), getwfj, printf(), puts(), putwQ, 
and scanfO all use gete() and putc(); they can be freely intermixed. 

Any program that uses the standard I/O package must include the header file of 
pertinent macro definitions. The functions and constants mentioned in the standard 
I/O package are declared in the header file and need no further declaration. The 
header file is included as follows: 

♦include <stdio . h> 

A file with associated buffering is called a stream and is declared to be a pointer to 
a defined type FILE. Fopen() creates certain descriptive data for a stream and 
returns a pointer to designate the stream in all further transactions. Normally, there 
are three open streams with constant pointers declared in the <stdio.h> header file 
and associated with the standard open files: 

stdin (standard input file) 

stdout (standard output file) 

stderr (standard error file) 

A constant NULL (0) designates a nonexistent pointer. 

An integer constant EOF (-1) is returned upon end-of-file or error by most integer 
functions that deal with streams. See the descriptions of the individual functions 
for details. 

The constants and the following functions are implemented as macros: getc(), 
getchar(), putcQ, putcharQ, feof(), ferror(), clearerr(), and fileno(). Redeclaration 
of these names should be avoided. 



NOTE 



<Stdio.h> includes definitions other than those described above, but their use is not 
recommended. 



DIAGNOSTICS 

Invalid stream pointers cause serious errors, possibly including program 
termination. Individual function descriptions describe the possible error conditions. 
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openO, close 0, "lseekO, readO, write 0, f close ( , ferrorO 
fopenO, freadO, fseek(), getcO, getsO, printfO, putcO, 
puts ( ) , scanf ( ) , setbuf ( ) , ungetc ( ) . 
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NAME 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen,strchr, strrchr 
— string operations 

SYNOPSIS 

char *strcat (si, s.2) 
char *sl, *s2; 

char *stmcat (si, s2, n) 
char *sl, *s2; 

int n; 

int strcmp (si, s2) 
char *sl, *s2; 

int strncmp (si, s2, n) 
char *sl, *s2; 
int n; 

char *strcpy (si, s2) 
char *sl, *s2; 

char *strncpy (si, s2, n) 
char *sl, *s2; 
int n ; 

int strlen (s) 
char *s; 

char *strchr (s, c) 
char *s, c; 

char *strrchr (s, c) 
char *s, c; 

DESCRIPTION 

The arguments sl,s2, and s point to strings (arrays of characters terminated by a 
null character). The functions strcat, strncat, strcpy, and strncpy all alter si . 
These functions do not check for overflow of the array pointed to by si. 

Strcat appends a copy of string s2 to the end of string si. Strncat appends at 
most n characters. Each function returns a pointer to the null-terminated result. 

Strcmp performs a comparison of its arguments according to the ASCII collating 
sequence and returns an integer less than, equal to, or greater than when si is 
less than, equal to, or greater than s2, respectively. Strncmp makes the same 
comparison but looks at a maximum of n characters. 

Strcpy copies string s2 to string si, stopping after the null character has been 
copied. Strncpy copies exactly n characters, truncating s2 or adding null 
characters to si if necessary. The result is not null-terminated if the length of s2 is 
n or more. Each function returns si. 

Strlen returns the number of characters in s, not including the terminating null 
character. 
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Strchr (strrchr) returns a pointer to the first Cast) occurrence of character c in 
string s; it returns a null pointer if c does not occur in the string. The null character 
terminating a string is considered to be part of the string. In previous versions of 
the Standard C Library, strchr was known as index() and strrchr was known as 
rindexQ. 

WARNING 

Overlapping moves may yield unexpected results 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 
—trigonometric functions 

SYNOPSIS 

#include <math.h> 

extended sin (x) 
extended x; 

extended cos (x) 
extended x; 

extended tan (x) 
extended x; 

extended asin (x) 
extended x; 

extended acos (x) 
extended x; 

extended atan (x) 
extended x; 

extended atan2 (y, x) 
extended x, y; 

DESCRIPTION 

Sin, cos, and tan return, respectively, the sine, cosine, and tangent of their 
argument, which is in radians. 

Asin returns the arcsine of x, in the range — rc/2 to nil. 

Acos returns the arccosine of x, in the range to %. 

Atan returns the arctangent of x, in the range -nil to %fl. 

Atan2 returns the arctangent of ylx, in the range -K to jc, using the signs of both 
arguments to determine the quadrant of the return value. 

For special cases, these functions return a NaN or infinity as appropriate. 

DIAGNOSTICS 

These functions honor the floating-point exception flags — invalid operation, 
underflow, overflow, divide by zero, and inexact — as prescribed by the Standard 
Apple Numeric Environment (SANE). 

NOTE 

Sin, cos, and tan have periods based on the nearest extended-precision 
representation of mathematical jt. Hence these functions diverge from their 
mathematical counterparts as their argument becomes far from zero. 

SEE ALSO 

Apple Numerics Manual. 
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NAME 

ungetc — push character back into input stream 

SYNOPSIS 

♦include <stdio.h> 

int ungetc (c, stream) 

char c; 

FILE *stream; 

DESCRIPTION 

Ungetc inserts the character c into the buffer associated with an input stream. That 
character, c, will be returned by the next getc() call on that stream. Ungetc returns 
c and leaves the file stream unchanged. 

One character of pushback is guaranteed provided something has been read from 
the stream and the stream is actually buffered. 

If c equals EOF, ungetc does nothing to the buffer and returns EOF. 

Fseek() erases all memory of inserted characters. 

DIAGNOSTICS 

For ungetc to perform correctly, a read must have been performed prior to the call 
of the ungetc function. Ungetc returns EOF if it can't insert the character. If 
stream is stdin, ungetc allows exactly one character to be pushed back onto the 
buffer without a previous read statement. 

SEE ALSO 

fseek<), getc(), setbuf(). 
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NAME 

unlink — remove a file 

SYNOPSIS 

int unlink (path) 
char *path; 

DESCRIPTION 

Unlink deletes the file named by the pathname pointed to by path. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 
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NAME 

write — write on a file 

SYNOPSIS 

int write (fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat() or open() call. 

Write attempts to write nbyte bytes from the buffer pointed to by buf to the file 
associated with the fildes. Internal limitations may cause write to write fewer 
bytes than requested; the number of bytes actually written is indicated by the return 
value. Several calls to write may therefore be necessary to write out the contents 
of buf. 

On devices capable of seeking, the actual writing of data proceeds from the position 
in the file indicated by the file pointer. Upon return from write, the file pointer is 
incremented by the number of bytes actually written. 

On nonseeking devices, writing always starts at the current position. The value of a 
file pointer associated with such a device is undefined. 

If the 0_APPEND file status flag is set — see open() — the file pointer is set to end- 
of-file prior to each write. 

Write fails and the file pointer remains unchanged if fildes is not a valid file 
descriptor open for writing, [ebadf] 

If you try to write more bytes than there is room for on the device, write writes as 
many bytes as possible. For example, if nbyte is 5 12 and there is room for 20 
bytes more on the device, write writes 20 bytes and returns a value of 20. The 
next attempt to write a nonzero number of bytes will signal an error, [enospc] 

RETURN VALUE 

Upon successful completion the number of bytes actually written is returned. 
Otherwise, -1 is returned and err no is set to indicate the error. 

SEE ALSO 

creat(), lseek(), open() . 
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7. 



Macintosh Interface Libraries 



This section contains the C definition of the Macintosh Interface Libraries. For complete documentation of 
these libraries, see Inside Macintosh. 

This section is arranged alphabetically by library name. The Library Index, Section 8, indexes; the defines, 
types, enumeration literals, global variables, and functions defined here and in the Standard C Library. 
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interface 



NAME 



C interface to the Macintosh libraries 



SYNOPSIS 

♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 



<types .h> 
<strings .h> 
<resources .h> 
<quickdraw . h> 
<f onts -h> 
<events .h> 
<windows .h> 
<controls .h> 
<inenus . h> 
<textedit -h> 
<dialogs .h> 
<desk.h> 
<scrap.h> 
<toolutils .h> 
<printing.h> 
<osutils .h> 
<memory .h> 
<segload.h> 
<osevents .h> 
<files.h> 
<devices.h> 
<disks .h> 
<sound.h> 
<retrace -h> 
<serial.h> 
<packages . h> 
<error .h> 
<sane.h> 



/* common defines and types 

/* string conversions 

/* Resource Manager 

/* QuickDraw 

/* Font Manager 

/* Event Manager 

/* Window Manager 

/* Control Manager 

/* Menu Manager 

/* TextEdit 

/* Dialog Manager 

Desk Manager 

Scrap Manager 

Toolbox Utilities 

Printing Manager 

Operating System Utilities 

Memory Manager 

Segment Loader 

OS Event Manager 

File Manager 

Device Manager 

Disk Driver 

Sound Driver 

Vertical Retrace Manager 

Serial Drivers 

packages 

System Error Handler 

SANE Numerics 



/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 



*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 



DESCRIPTION 

The C Interface provides C programs with access to all of the libraries defined in 
Inside Macintosh. Constants, types, and library routines are provided. The list 
of libraries appears above. 

Header Files — Include the ".h" files in C programs to declare the defines, types, 
and functions provided by these libraries. Each library definition lists the includes 
necessary for use of that library. Functions whose declarations can be inferred 
from calls have been omitted from the header files. List the includes in the order in 
which the libraries are listed above. 

Object File — The interface code is contained in file interface. obj. Link this file with 
the C program and other libraries. Not all functions require interface code. The 
linker includes interface code for only those routines that are called. 

Interface Implementation — Most library routines are declared as external Pascal 
routines with trap numbers, and are trapped to directly by compiled code. Other 
routines are declared to be C routines and are called through interf ace glue. 

Parameter Types — The C interfaces expect structures (including Points) to be 
passed by address. String parameters are C strings (i.e., zero- terminated) unless 
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otherwise indicated. ResTypes and OSTypes can be expressed as character literals 
(e.g., 'MENU'). 

Spelling and Capitalization— The spelling and capitalization of identifierjs is exactly 
as specified in Inside Macintosh. Constants, variables, parameter names, fields 
within structures, and enumeration-type elements begin with a lowercase letter. 
Routines and data types begin with an uppercase letter. Letters that begin new 
words in English are capitalized. All other letters are lowercase. When a name 
includes an acronym, the case of the entire acronym is determined by th^ case of the 
first letter (e.g., GetOSEvent, teJustLeft). 
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NAME 

controls — Control Manager 


SYNOPSIS 

#include <types.h> 
#include <controls.h> 


/* Control Definition Procedures IDs */ 


#define pushButProc 
fdefine checkBoxProc 1 
#defLne radioButProc 2 
#defLne useWFont 8 
fdefine scrollBarProc 16 


/* FindControl Result Codes */ 


#define inButton 10 
#define inCheckbox 11 
#define inUpButton 20 
fdefine inDownButton 21 
idefine inPageUp 22 
#define inPageDown 23 
#define inThumb 12 9 


/* DragControl Axis Constraints */ 


#define noConstraint 
fdefine hAxisOnly 1 
fdefine vAxisOnly 2 


/* Messages to Control definition function */ 


fdefine drawCntl 
fdefine testCntl 1 
fdefine calcCRgns 2 
fdefine initCntl 3 
fdefine dispCntl 4 
fdefine posCntl 5 
fdefine thumbCntl 6 
fdefine dragCntl 7 
fdefine autoTrack 8 


typedef struct ControlRecord { 

struct ControlRecord **nextControl; 
struct GrafPort *contrlOwner; 
Rect contrlRect ; 
unsigned char contrlVis; 
unsigned char contrlHilite; 
short contrlValue; 
short contrlMin; 
short contrlMax; 
ProcHandle contrlDefProc; 
Handle contrlData; 
ProcPtr contrlAction; 
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long contrlrfCon; 

Str255 contrlTitle; 
} ControlRecord, *ControlPtr, **ControlHandle; 



/* Initialization and Allocation */ 

ControlHauUle NewCuiitioi. ("CheWiiiduw,£)UuudsKect, txtle, visilije, vctlut;, 
min,max,jji.ucID, refCon) 

ocxuct Graf Port *theWindow,- 

Rect *boundsRect,- 

uhar *title; 

Boolean visible ,- 

short value,- 

short rniu,- 

short max; 

short procii); 

long refCon; 
pascal ControlHandle GetNewControl (controlID, theWindow) 

short controlID,- 

atruct GrafPort *thewindow; 
pdscal void DisposeCoiitrol (thecontiul) 

ControlHandle theControl, 
paoual void KillControls (theWindow) 

struct GrafPort *theWindow^ 

/* Control Display */ 

void SetCTitle (theControl, title) 

ControlHandle theControl; 

char *title; 
void GetCTitle (theControl, title) 

ControlHandle theControl ; 

char *title; 
pascal void HideControl (theControl) 

ControlHandle theControl; 
pascal void ShowControl (theControl) 

ControlHandle theControl; 
pascal void DrawControls (theWindow) 

struct GrafPort *theWindow; 
pascal void HiliteControl (theControl, hiliteState) 

ControlHandle theControl; 

short hiliteState; 

/* Mouse Location */ 

short TestControl (theControl, thePoint) 

ControlHandle theControl; 

Point *thePoint; 
short FindControl (thePoint, theWindow, theControl) 

Point *thePoint; 

struct GrafPort *theWindow; 

ControlHandle *theControl; 
short TrackControl (theControl, startPt, actionProc) 

ControlHandle theControl; 

Point *startPt; 

ProcPtr actionProc; 
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/* Control Movement and Sizing */ 

pascal void MoveControl (theControl,h, v) 

ControlHandle theControl; 

short h,v; 
void DragControl (theControl, startPt, limitRect, slopRect \ axis) 

ControlHandle theControl; 

Point *startPt; 

Rect *limitRect; 

Rect *slopRect; 

short axis; 
pascal void SizeControl (theControl, w,h) 

ControlHandle theControl; 

short w,h; 

/* Control Settings and Range */ 

pascal void SetCtlValue (theControl, theValue) 

ControlHandle theControl; 

short theValue; 
pascal short GetCtlValue (theControl) 

ControlHandle theControl; 
pascal void SetCtlMin (theControl, minValue) 

ControlHandle theControl; 

short minValue; 
pascal short GetCtlMin (theControl) 

ControlHandle theControl; 
pascal void SetCtlMax (theControl, maxValue) 

ControlHandle theControl; 

short maxValue ; 
pascal short GetCtlMax (theControl) 

ControlHandle theControl; 

/* Miscellaneous Utilities */ 

pascal void SetCRef Con (theControl, data) 

ControlHandle theControl; 

long data; 
pascal long GetCRefCon (theControl) 

ControlHandle theControl; 
pascal void SetCtlAction (theControl, actionProc) 

ControlHandle theControl; 

ProcPtr actionProc; 
pascal ProcPtr GetCtlAction (theControl) 

ControlHandle theControl; 



USER ROUTINES 

pascal void MyAction() 

pascal void MyAction (theControl, partCode) 

ControlHandle theControl; 

short partCode; 

pascal long MyControl (varCode, theControl, message, param) 
short varCode; 
ControlHandle theControl; 



Page 73 



Ex Libris • David T Craig • August 2009 Page 0081 of 021 2 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 
CONTROLS Macintosh Interface Libraries CONTROLS 



short message; 
long param; 



DESCRIPTION 



The Control Manager provides routines for creating and manipulating controls 
(e.g., buttons, scroll bars). r 

For more detailed information see the Control Manager chapter of Inside 
Macintosh. 
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DESK 



NAME 



desk — Desk Manager 



SYNOPSIS 

#include <types.h> 
#include <desk.h> 

/* Opening and Closing Desk Accessories */ 

short OpenDeskAcc (theAcc) 

char *theAcc; 
pascal void CloseDeskAcc {refNum) 

short refNum; 

/* Handling Events in Desk Accessories */ 

pascal void SystemClick(theEvent/theWindow) 

struct EventRecord *theEvent; 

struct GrafPort *theWindow; 
pascal Boolean SystemEdit (editCmd) 

short editCmd; 

/* Performing Periodic Actions */ 
pascal void SystemTaskO 
/* Advanced Routines */ 

pascal Boolean SystemEvent (theEvent) 

struct EventRecord *theEvent; 
pascal void SystemMenu (menuResult) 

long menuResult; 

DESCRIPTION 

The Desk Manager supports desk accessories. 

Warning: The names of desk accessories start with a null byte. The output 
parameter from GetMenuItem will return a string that begins with a null byte when 
a desk accessory is selected from the Apple menu. OpenDeskAcc skips over this 
null byte when interpreting its parameter 

For more detailed information see the Desk Manager chapter of Inside 
Macintosh. 



NOTE 



Desk accessories do not have an A5 global area. Therefore all of the code for a 
desk accessory must reside in a single sement; no global variables may be declared; 
and no string constants may be used. 
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NAME 






devices — Device Manager 




~_ SYNOPSIS 






# include 


<types.h> 




♦include 


<osutils-h> 




#include 


<de vices -h> 




/* error 


codes */ 




♦define 


abortErr (-27) 


/* I/O request abortedby Ki.llIO */ 


♦define 


badUnitErr (-21) 


/* RefNum doesn't match uni^ - . table */ 


♦define 


controlErr (-17) 


/* Driver can't respond to t^his call */ 


♦define 


dlnstErr (-26) 


/* Couldn't find driver in ^:esource file */ 


♦define 


dRemoveErr (-25) 


/* Tried to remove an open dlriver */ 


♦define 


noErr 


/'* No error */ 


♦define 


notOpenErr (-28) 


/* Driver isn't open */ 


♦define 


openErr (-23) 


/* Requested r/w permission doesn't */ 
/* match driver's open permission */ 


♦define 


readErr (-19) 


/* Driver can't respond to Read calls */ 


♦define 


statusErr (-18) 


/* Driver can't respond to> Status call */ 


♦define 


unitEmptyErr (-22) 


/■* Reference number specifies nil handle */ 
/* in unit table */ 






♦define 


writErr (-20) 


/* Driver can't respond to Write calls */ 


typedef £ 


truct CntrlParam { 




struct 


QElem *qLink; 


/* next queue entry */ 


short 


qType; 


/* queue type */ 


short 


ioTrap; 


/.* routine trap */ 


Ptr 


ioCmdAddr; 


/* routine address */ 


ProcPtr ioCompletion; 


/* completion routine */ 


OSErr 


ioResult; 


/* result code */ 


char 


*ioNamePtr; 


/* volume or file name */ 


short 


ioVRefNum; 


/* volume refnum or drive number */ 


short 


ioCRefNum; 


/* refnum for I/O operation */ _ 


short 


csCode ; 


/* word for control status -ode */ 


short 


csParam[ll] 


/* operation-defined parameters */ 


} CntrlParam; 




typedef struct DCtlEntry { 




Ptr 


dCt ID river ; 


/* ptr to ROM or handle to RAM driver */ 


short 


dCtlFlags; 


/* flags */ 


QHdr 


dCtlQHdr; 


/* driver's I/O queue */ 


long 


dCtlPosition; 


/* byte pos used by read and write */ 


Handle dCtlStorage; 


/* handle to RAM driver's storage */ 


short 


dCtlRefNum; 


/* driver's reference number */ 


long 


dCtlCurTicks; 


/* counter for timing system 1 task calls */ 


Ptr 


dCtlWindow; 


/* ptr to driver's window [if: any) */ 


short 


dCtlDelay; 


/* # of ticks between sysTasc calls */ 


short 


dCtlEMask; 


/* desk accessory event mas. */ 


short 


dCtlMenu; 


/* menu ID of menu associated w/ driver */ 


} DCtlEntry, *DCtlPtr, **DCtlHandle; 


|: 
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/* High-Level Routines */ 

OSErr OpenDriver (name, refNum) 

char *name; 

short *refNum; 
OSErr CloseDriver (refNum) 

short refNum; 
OSErr Control (refNum, csCode, csParam) 

short refNum, csCode; 

Ptr csParam; 
OSErr Status (refNum, csCode, csParam) 

short refNum, csCode; 

Ptr csParam; 
OSErr KilllO (refNum) 

short refNum; 



/* Low-Level Routines */ 

OSErr PBControl (paramBlock, async) 

CntrlParam *paramBlock; 

Boolean async; 
OSErr PBStatus (paramBlock, async) 

CntrlParam *paramBlock; 

Boolean async; 
OSErr PBKilllO (paramBlock, async) 

CntrlParam *paramBlock; 

Boolean async; 



/* Accessing a Driver's I/O Queue */ 

DCtlHandlej GetDCtlEntry (refNum) 

short- refNum; 



DESCRIPTION c .^ . , „ . 

The Device Manager controls the exchange of information between an application 

and devices. 

For more detailed information see the Device Manager chapter of Inside 
Macintosh, 
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NAME 




dialogs — Dialog Manager 




SYNOPSIS 




♦include <types . h> 




#include <quickdraw.h> 




♦include <windows.h> 




♦include <dialogs.h> 




/* Item types */ 




♦define ctrlltem 4 /* add to following four constants 


*/ 


♦define btnCtrl /* standard button control 


*/ 


♦define chkCtrl 1 /* standard check box control 


*/ 


♦define radCtrl 2 /* standard "radio button" -rmtrol 


*/ 


♦define resCtrl 3 /* control defined in controJ template 


*/ 


♦define statText 8 /* static text 


*/ 


♦define edit Text 16 /* editable text (dialog only) 


*/ 


♦define iconltem 32 /* icon 


*/ 


♦define picltem 64 /* Quickdraw picture 


*/ 


♦define userltem /* application-defined item idialog only)*/ 


♦define itemDisable 128 /* add to any of above to disable 


*/ 


/* Item numbers of OK and Cancel buttons */ 




♦define ok 1 /* OK button is first by con'temtion 


*/ 


♦define cancel 2 /* Cancel button is second by, convention 


*/ 


/* Resource IDs of Alert icons */ 




♦define stoplcon 




♦define notelcon 1 




♦define ctnlcon 2 




typedef WindowPtr DialogPtr; 




typedef struct DialogRecord { 




WindowRecord window ,- 




Handle items; 




struct TERec **textH; 




short editField; 




short editOpen; 




short aDefltem; 




) DialogRecord, *DialogPeek; 




typedef struct DialogTemplate { 




Rect boundsRect ; 




short procID; 




Boolean visible; 




Boolean fillerl; 




Boolean goAwayFlag; 




Boolean filler2; 




long refCon; 




short items ID; 




Str255 title; 




} DialogTemplate, *DialogTPtr, **DialogTHndl; 
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typedef long StageList; 

typedef struct AlertTemplate { 

Rect boundsRect; 

short iterasID; 

StageList stages; 
} AlertTemplate, *AlertTPtr, **AlertTHndl; 



/* Initialization */ 

pascal void InitDialogs (restartProc) 

ProcPtr restartProc; 
pascal void ErrorSound(soundProc) 

ProcPtr soundProc; 
void SetDAFont (f ontNum) 

short fontNum; 

/* Creating and Disposing of Dialogs */ 

Uidxugfcx NewDiaioy (dS'LOJ-ciyfc, buunQshect, utit, visiuit, prociL , benina, 
yoAwayFlag, refCon, items' 
Pux dstorage, 
Reci. *boundsk«cw 
oUcj.x. *titj-t;> 
Booleaii \zisiole; 
cihort procID; 
WindowPtr behind; 
Boolean goAwayFlay, 
long refCoii, 
Handle itertib^ 

pcoudl DialogPti" GetNewD i alog ( d i alogID/ c L storage, behind) 

short dialogiu,- 

Ptr dstorage; 

WindowPtr behind, 
pasudl void CloseDiaxuy (theuialuyj 

DialogPtr theDialog; 
pascal void DisposDialoy (theDidlog; 

DialogPtr theDialoy, 
pascal void CouldDialog (diaj-uglD; 

short dialogic, 
pascal void FreeDaalog (diaiuglD; 

eihort dialogID, 

/* Handling Dialog Events */ 

pascal void ModalDialog(filterProc, itemHit) 

ProcPtr filterProc; 

short * itemHit; 
pascal Boolean IsDialogEvent (theEvent) 

struct EventRecord *theEvent; 
pascal Boolean DialogSelect (theEvent, theDialog, itemHit) 

struct EventRecord *theEvent; 

DialogPtr *theDialog; 

short * itemHit; 
void DlgCut (theDialog) 
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DialogPtr theDialog; 
void DlgCopy (theDialog) 

DialogPtr theDialog; 
void DlgPaste (theDialog) 

DialogPtr theDialog; 
void DlgDelete (theDialog) 

DialogPtr theDialog; 
pascal void DrawDialog (theDialog) 

DialogPtr theDialog; 

/* Invoking Alerts */ 

pascal short Alert (alertID, filterProc) 

short alertID; 

ProcPtr filterProc; 
pascal short StopAlert (alertID, filterProc) 

short alertID; 

ProePtr filterProc; 
pascal short NoteAlert (alertID, filterProc) 

short alertID; 

ProcPtr filterProc; 
pascal short CautionAlert (alertID, filterProc) 

short alertID; 

ProcPtr filterProc; 
pascal void CouldAlert (alertID) 

short alertID; 
pascal void FreeAlert (alertID) 

short alertID; 

/* Manipulating Items in Dialogs and Alerts */ 

void ParamText (parant0,paraml,param2,param3) 

char *paramO-; 

char *paraml; 

char *param2; 

char *param3; 
pascal void GetDItem (theDialog, itemNo, type, item, box) 

DialogPtr theDialog; 

short itemNo; 

short *type; 

Handle *item; 

Rect *box; 
pascal void SetDItem (theDialog, itemNo, type, item, box) 

DialogPtr theDialog; 

short itemNo; 

short type; 

Handle item; 

Rect *box; 
void GetlText (item, text) 

Handle item; 

char *text; 
void SetlText (item, text) 

Handle item; 

char *text; 
pascal void SellText (theDialog, itemNo, startSel,endSel) 

DialogPtr theDialog; 

short itemNo; 
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short startSel; 

short endSel; 
short GetAlrtStage () 
void ResetAlrtStage () 

USER ROUTINES 

pascal void MyItem(theWindow, itemNo) 

struct GrafPort *theWindow; 

short itemNo; 
pascal void MySound(soundNo) 

short soundNo; 
pascal Boolean MyFilter (theDialog, theEvent, itemHit) 

DialogPtr theDialog; 

struct EventRecord *theEvent; 

short *itemHit; 

DESCRIPTION 

The Dialog Manager supports dialog boxes and the alert mechanism. 

For more detailed information see the Dialog Manager chapter of Inside 
Macintosh. 

NOTE 

StageList is defined as a long, rather than specifying the bits. 
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NAME 










disks — Disk Driver 








SYNOPSIS 










#include 


<types.h> 








♦include 


<disks.h> 








/* error 


codes */ 








#define 


firstDskErr 


'-84) 


/* 


First of the range of disk errors */ 


tdefine 


lastDskErr 


(-64) 


/* 


Last of the range of d|LsX errors */ 


♦define 


badBtSlpErr 


(-70) 


/* 


Bac address mark */ 


tdefine 


badCksmErr 


[-69) 


/* 


Bac address mark */ 


#define 


badDBtSlp 


(-73) 


/* 


Bac data mark * 


♦define 


badDCksum 


[-72) 


/* 


Bac data mark * 


♦define 


cantStepErr 


(-75) 


/* 


hardware error * ' 


♦define 


dataVerErr 


(-68') 


/* 


Read-verify failec */ 


♦define 


initlWMErr 


(-77) 


/* 


Hardware error * 


♦define 


noAdrMkErr 


[-67) 


/* 


Can't find an adares.' itiarj */ 

Drive isn't connectec * 


♦define 


noDriveErr 


-64) 


/* 


♦define 


noDtaMkErr 


-71) 


/* 


Can't find dat; marx *? 


♦define 


noErr 





/* 


No error * 


♦define 


noNybErr 


-66) 


/* 


Disk is probably blanK'*' 


♦define 


nsDrvErr 


-56) 


/* 


No such drive *■ 


♦define 


offLinErr 


-65) 


/* 


No disk in drive * 


♦define 


paramErr 


-50) 


/* 


Bad positioning mlormaiiiioi */ 


♦define 


sectNFErr 


-81) 


/* 


Can't find sectoi */ 


♦define 


seekErr 


-80) 


/* 


Hardware error * 


♦define 


spdAdjErr 


-79) 


/* 


Hardware error * 


♦define 


tkOBadErr 


-76) 


/* 


Hardware error * 


♦define 


twoSideErr 


-78) 


/* 


Triec to read sid* 2, qi 1 side drive */ 


♦define 


wPrErr 


-44) 


/* 


Dis* it loekee * 


♦define 


wrUnderrun ( 


-74) 


/* 


write unaerrui occurrec */ 


typedef 


struct DrvSts \ 








short 


track; 




/* 


current tract, * 


char 


writePrc 


t; 


/* 


bit 7=1 if volume is iopjcec */ 


char 


disklnPl 


ace; 


/* 


disk 11 place * 


char 


installs 


d; 


/* 


drive installec */ 


char 


sides; 




/* 


bit 7=0 if singie-sided, drive */ 


struct QElem *qLink; 




/* 


next queue entry */ 


short 


qType ; 




/* 


not used */ 


short 


dQDrive; 




/* 


drive number */ 


short 


dQRefNurr 


i; 


/* 


driver reference number 1 * 


short 


dQFSID; 




/* 


file-system identifier j* 


char 


twoSideF 


nit; 


/* 


-1 if two-sidec disx */ 


char 


needsFlu 


sh; 


/* 


reserved * 


short 


diskErrs 


; 


/* 


erroi count */ 


} DrvSts 


r 








OSErr DiskE ject (drvNum) 








short 


drvNum; 








OSErr SetTagBuf f er (buf t 


:Ptr) 






Ptr buffPtr; 
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OSErr DriveStatus (drvNum, status) 
short drvNum; 
DrvSts *status; 

DESCRIPTION 

The Disk Driver is a Macintosh device driver used for storing and retrieving 
information on Macintosh 3 1/2-inch disk drives. 

For more detailed information see the Disk Driver chapter of Inside Macintosh. 
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error — System Error Handler 










SYNOPSIS 












♦include 


<error.h> 










/* error 


codes */ 










♦define 


dsBusErr 


1 


/* 


bu, L->±. J-U. 


*/ 


♦define 


dsAddressErr 


2 


/* 


Ada^=.-j. Liiuj 


*/ 


♦define 


dsIlilnstErr 


3 


/* 


Illega Ins^utCiu: 


*/ 


♦define 


dsZeroDivErr 


4 


/* 


Zero D-Lxricu 


*/ 


♦define 


dsChkErr 


5 


/* 


Check Exoepcx-^. 


*/ 


♦define 


dsOvflowErr 


6 


/* 


TrapV Exception 


*/ 


♦define 


dsPrivErr 


7 


/* 


Privilege Violacj.^. 


*/ 


♦define 


dsTraceErr 


8 


/* 


Trace Except i^.- 


*/ 


♦define 


dsLineAErr 


9 


/* 


Line 1010 Excepc^o. 


*/ 


♦define 


dsLineFErr 


10 


/* 


Line 1111 Excepts 


*/ 


♦define 


dsMiscErr 


11 


/* 


Miscellaneous Excepc^u. 


1 */ 


♦define 


dsCoreErr 


12 


/* 


Un implemented Core Routj-n- */ 


♦define 


dsIrqErr 


13 


/* 


Spurious Interrupt 


*/ 


♦define 


dsIOCoreErr 


14 


/* 


I/O System Error 


*/ 


♦define 


dsloadErr 


15 


/* 


Segment Loader Error 


*/ 


♦define 


dsFPErr 


16 


/* 


Floating Point Error 


*/ 


♦define 


dsNoPackErr 


17 


/* 


Can't Load Package 


*/ 


♦define 


dsNoPkl 


18 


/* 


Can't Load Package 1 


*/ 


♦define 


dsNoPk2 


19 


/* 


Can't Load Package 2 


*/ 


♦define 


dsNoPk3 


20 


/* 


Can't Load Package 3 


*/ 


♦define 


dsNoPk4 


21 


/* 


Can't Load Package 4 


*/ 


♦define 


dsNoPk5 


22 


/* 


Can't Load Package 5 


*/ 


♦define 


dsNoPk6 


23 


/* 


Can't Load Package 6 


*/ 


♦define 


dsNoPk7 


24 


/* 


Can't Load Package 7 


*/ 


♦define 


dsMemFullErr 


25 


/* 


Out of Memory 


*/ 


♦define 


dsBadLaunch 


26 


/* 


Segment Loader Error 


*/ 


♦define 


dsFSErr 


27 


/* 


File Map Trashed 


*/ 


♦define 


dsStkNHeap 


28 


/* 


Stack Overfly-' Error 


*/ 


♦define 


dsReinsert 


30 


/* 


Please Inser the Disk 


*/ 


♦define 


dsNotThel 


31 


/* 


ThJ. is No- txi... Correc 


t iiJxS- i, i 


♦define 


dsSysErr 32767 


/* 


Sys\_-c.i Li.j.u. 


*/ 


void SysError(errorCode) 










short 


errdfCode; 










UfcSCHIKIIUP 












The S^sutiii <Lu.it-> Handler 1 ' i5 tUi ' f ca> - 


01 lliC iVxaCiXlLOSil Op-^ldUiig Cjjraiciil tiia 


assumes 


control Wiicii a lata! 


eiror occurs. 


For more detailed information, sec tn. 


System Error Handler chapt 


er of Inside Macintos" 
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NAME 




events — Toolbox Event Manager 


SYNOPSIS 




♦include <types.h> 




♦include <events.h> 




/* Event Types */ 




#define nullEvent 





#define mouseDown 


i 


#define mouseup 


2 


#define keyDown 


3 


#define keyUp 


4 


♦define autoKey 


5 


♦define updateEvt 


6 


♦define diskEvt 


7 


♦define activateEvt 


8 


♦define networkEvt 


10 


♦define driverEvt 


11 


♦define applEvt 


12 


♦define app2Evt 


13 


♦define app3Evt 


14 


♦define app4Evt 


15 


/* Masks for accessing 


r keyboard event message */ 


♦define charCodeMask 


OxOOOOOOFF 


♦define keyCodeMask 


OxOOOOFFOO 


/* Event Masks */ 




♦define mDownMask 


2 


♦define rnUpMask 


4 


♦define keyDownMask 


8 


♦define keyUpMask 


16 


♦define autoKeyMask 


32 


♦define updateMask 


64 


♦define diskMask 


128 


♦define activMask 


256 


♦define networkMask 


1024 


♦define driverMask 


2048 


♦define applMask 


4096 


♦define app2Mask 


8192 


♦define app3Mask 


16384 


♦define app4Mask ( 


-32768) 


♦define everyEvent 


(-1) 


/* Modifiers */ 




♦define activeFlag 


1 


♦define btnState 


128 


♦define cmdKey 


256 


♦define shiftKey 


512 


♦define alphaLock 


1024 


♦define optionKey 


2048 
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typedef struct EventRecord { 

short what; 

long message; 

long when ; 

Point where; 

short modifiers ; 
} EventRecord; 

typedef long KeyMap [ 4 ] ; 



/* Accessing Events */ 

pascal Boolean GetNextEvent (eventMask, theEvent) 
short eventMask; 
EventRecord *theEvent; 

pascal Boolean Event Avail (eventMask, theEvent) 
short eventMask; 
EventRecord *theEvent; 



/* Reading the Mouse */ 

pascal void GetMouse (mouseLoc) 

Point *mouseL©c; 
pascal Boolean Button () 
pascal Boolean StillDownO 
pascal Boolean WaitMouseUp ( ) 



/* Reading the Keyboard and Keypad */ 

pascal void GetKeys (theKeys) 
KeyMap *theKeys; 



/* Miscellaneous Routines */ 

pascal long TickCountO 
long GetDblTimeO 
long GetCaretTimeO 



DESCRIPTION 

The Toolbox Event Manager provides access to the Macintosh keyboard, keypad, 
and mouse. The keyboard bit map returned by the function GetKeysO is organized 
as shown below. The bits aren't numbered as you might expect. Here is the actual 
numbering scheme, corresponding to the key code numbers given in the Key Codes 
figure in the Toolbox Event Manager chapter of Inside Macintosh. 
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keyMap[0] keyMap[l] keyMap[2] keyMap[3] 
I III 

I III 

V V V V 

bytes b0,bl,b2,b3 b4,b5, bl2,bl3,bl4,bl5 

I \ I 

I \ I 

v \ v 

bits 7,6,5,4,3,2,1,0 | 127, 126,125, 124, 123, PL22, 121, 120 

v 
15,14,13,12,11,10,9,8 
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NAME 












files — File Manager 










SYNOPSIS 












# in elude 


-ctypes .h> 










#include 


<files.h> 










/* error 


codes */ 










#def ine 


badMDBErr 


(-60) 


/* 


Master directory block is bad, reinit 


*/ 


♦define 


bdNamErr 


(-37) 


/* 


Bad file or volume name '(zero length?) 


*/ 


# define 


dirFulErr 


-33) 


/* 


File directory "full */ -; 




#def ine 


dskFulErr 


'-34) 


/* 


All allocation blocks ar£ full */ 




#def ine 


dupFNErr 


-48) 


/* 


File by that name already exists */ 




♦define 


eofErr 


-39) 


/* 


Logical EOF reached during read */ 




#define 


extFSErr 


-58) 


/* 
/* 


External file system; identifier is */ 
non-zero or refNum is > 1024 */ 




♦define 


fBsyErr 


-47) 


/* 


One or more files are open */ 




#define 


fLokdErr 


-45) 


/* 


File Locked */ 




#define 


fnfErr 


-43) 


/* 


File not found */ 




♦define 


fnOpnErr 


-38) 


/* 


File not open */ 




#define 


fsRnErr ( 


-59) 


/* 


Problem during rename */ 




#define 


ioErr 


-36) 


/* 


Disk I/O error */ 




# define 


noErr 





/* 


No error */ 




♦define 


nsDrvErr 


-56) 


/* 


No such drive in the drive queue */ 




♦define 


noMacDskErr 


-57) 


/* 


Volume lacks Mac-format directory */ 




♦define 


nsvErr 


-35) 


/* 


Specified volume doesn't -exist */ 




♦define 


opWrErr 


-49) 


/* 


Only one writer allowed */ 




♦define 


paramErr 


-50) 


/* 


Parameter's don't specify an existing 


*/ 








/* 


volume and there's no default volume 


*/ 


♦define 


permErr 


-54) 


/* 


Permission doesn't allow Iwriting */ 




♦define 


posErr 


-40) 


/* 


Attempted to position before start */ 




♦define 


rfNumErr 


-51) 


/* 


Bad reference number */ 




♦define 


tmfoErr 


-42) 


/* 


Only 12 files can be open at once */ 




♦define 


volOffLinErr 


-53) 


/* 


Volume not on-line */ 




♦define 


volOnLinErr 


-55) 


/* 


Volume is already mounted and on-line 


*/ 


♦define 


vLckdErr 


-46) 


/* 


Volume is locked by a software flag */ 




♦define 


wrPermErr 


-61) 


/* 


Permission does not allow writing */ 




♦define 


wPrErr 


-44) 


/* 


Volume is locked by a hardware setting 


*/ 


/* Flags 


in file inforn 


ration used 


by the Finder */ 




♦define 


fHasBundle f 


192 


/* 


set if file has a bundle */ 




♦define 


flnvisible 1( 


>384 


/* 


set if file's icon is invisible */ 




♦define 


fTrash 


(-3) 


/* 


file is in trash window */ 




♦define 


fDesktop 


(-2) 


/* 


file in on desktop */ 




♦define 


fDisk 





/* 


file is in disk window */ 




/* Values for posMode and ioPosMode */ 




♦define 


fs&tMark 





/* 
/* 


at current position of mark */ 

(posOff or ioPosOffset ignored) */ 
offset relative to beginning of file */ 




♦define 


f sFromStart 


1 


/* 




♦define 


fsFromLEOF 


2 

Page 
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♦define 


fsFromMark 3 


/* offset relative to current mark */ 


♦define 


rdVerify 64 


/* added to above for read-verify */ 


/* Values 


for requesting read/write access */ 


#def ine 


fsCurPerm 


/* whatever is currently; allowed */ 


♦define 


fsRdPerm 1 


/* request to read only */ 


♦define 


fsWrPerm 2 


/* request to write only */ 


♦define 


fsRdWrPerm 3 


/* request to read and write */ 


typedef struct FInfo { 




OSType 


f dType ; 


/* the type of the file */ 


OS Type 


fdCreator; 


/* file's creator */ 


short 


fdFlags; 


/* flags. hasBundle, invisible, etc. */ 


Point 


fdLocation; 


/* file's location in wiiidow */ 


short 


fdFldr; 


/* folder containing file */ 


} FInfo ; 






/* Parameter Blocks */ 




typedef struct IOParam { 




struct 


QElem *qLink; 


/* next queue entry */ 


short 


qType; 


/* queue type */ 


short 


ioTrap; 


/* routine trap */ 


Ptr 


iodmdAddr ; 


/* routine address */ 


ProcPtj 


c ioCompletion; 


/* completion routine */ 


OSErr 


ioResult; 


/* result code */ 


StringPtr ioNamePtr; 


/* volume of file name */■ 


short 


ioVRefNum; 


/* volume refnum or drive: number */ 


short 


ioRefNum; 


/* path reference number */ 


char 


ioVersNum; 


/* version number */ 


char 


ioPermssn; 


/* read/write permission */ 


Ptr 


ioMisc; 


/* miscellaneous (Note: use high byte */ 
/* for PBSetFVers) */ 


Ptr 


ioBuf fer; 


/* data buffer */ 


long 


ioReqCount ; 


/* requested number of bytes */ 


long 


ioActCount; 


/* actual byte count completed */ 


short 


ioPosMode; 


/* newline char and type of positioning */ 


long 


ioPosOf f set; 


/* size of positioning offset */ 


} IOParam; 






typedef struct FileParam { 




struct 


QElem *qLink; 


/* next queue entry */ 


short 


qType; 


/* queue type */ 


short 


ioTrap; 


/* routine trap */ 


Ptr 


ioCmdAddr; 


/* routine address */ 


ProcPti 


ioCompletion; 


/* completion routine */ 


OSErr 


ioResult; 


/* result code */ 


StringPtr ioNamePtr; 


/* volume of file name */' 


short 


ioVRefNum; 


/* volume refnum or drive number */ 


short 


ioFRefNum; 


/* path reference number */ 


char 


ioFVersNum; 


/* version number */ 


char 


fillerl; 


/* not used */ 
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short 


ioFDir Index; 


/* sequence number of file */ 


char 


ioFlAttrib; 


/* file attributes */ 


char 


ioFlVersNum; 


/* version number */ 


FInfo 


ioFlFndrlnfo; 


/* information used by the Finder */ 


long 


ioFlNum; 


/* file number */ 


short 


ioFlStBlk; 


/* first block of data fork */ 


long 


ioFlLgLen; 


/* logical EOF of data fork >/ 


long 


ioFlPyLen; 


/* phyisical EOF of data fork */ 


short 


ioFlRStBlk; 


/* first block of resource fork */ 


long 


ioFlRLgLen; 


/* logical EOF of resource fork */ 


long 


ioFlRPyLen; 


/* physical EOF of resource fork */ 


long 


ioFlCrDat; 


/* date and time of creation */ 


long 


ioFlMdDat; 


/* date and time of last modification */ 


} FilePararn; 






typedef struct VolumeParam { 




struct QElem *qLink; 


/* next queue entry */ 


short 


qType; 


/* queue type */ 


short 


ioTrap; 


/* routine trap */ 


Ptr 


ioCmdAddr; 


/* routine address */ 


ProcPtr 


ioCompletion; 


/* completion routine */ 


OSErr 


ioResult; 


/* result code */ 


StringPtr 


ioNamePtr; 


/* volume of file name */ 


short 


ioVRefNum; 


/* volume refnum or drive number */ 


long 


filler2; 


/* not used */ 


short 


ioVolIndex; 


/* volume index */ 


long 


ioVCrDate; 


/* date and time of initialization */ 


long 


ioVLsBkUp; 


/* date and time of last volume backup */ 


short 


ioVAtrb; 


/* bit 15=1 if volume locked:*/ 


short 


ioVNmFls; 


/* number of files in file directory */ 


short 


ioVDirSt; 


/* first block of file directory */ 


short 


ioVBILn; 


/* number of blocks in file directory */ 


short 


ioVNmAlBlks; 


/* number of alloc blocks on volume */ 


long 


ioVAlBlkSiz;; 


/* number of bytes per alloc block */ 


long 


ioVClpSlz; 


/* number of bytes to Allocate */ 


short 


ioAlBlSt; 


/* first block in volume block map */ 


long 


ioVNxtFNum; 


/* next free file number */ 


short 


ioVFrBlk; 


/* number of free allocation blocks */ 


} VolumeParam; 




typedef struct VCB { 




struct QElem *qLink; 


/* next, queue entry */ 


short 


qType; 


/* not used */ 


short 


vcbFlags; 


/* bit 15=1 if dirty */ 


short 


vcbSigWord; 


/* always 0xd2d7 */ 


long 


vcbCrDate; 


/* date volume was initialized */ 


long 


vcbLsBkUp; 


/* date of last backup */ 


short 


vcbAtrb; 


/* volume attributes */ 


short 


vcbNmFls; 


/* number of files in directory */ 


short 


vcbDirSt; 


/* directory's first block */ 


short 


vcbBILn; 


/* length of file directory */ 


short 


vcbNmBlks; 


/* number of allocation blocks */ 


long 


vcbAlBlkSiz; 


/* size of allocation blocks */ 


long 


vcbClpSiz; 


/* number of bytes to Allocate */ 


short 


vcbAlBlSt; 


/* first block in block map */ 
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long 


vcbNxtFNum; 


/* 


short 


vcbFreeBks; 


/* 


String(27) 


vcbVN; 


/* 


short 


vcbDrvNum; 


/* 


short 


vcbDRefNum; 


/* 


short 


vcbFSID; 


/* 


short 


vcbVRefNum; 


/* 


Ptr 


vcbMAdr ; 


/* 


Ptr 


vcbBufAdr; 


/* 


short 


vcbMLen; 


/* 


short 


vcbD ir Index; 


/* 


short 


vcbDirBlk; 


/* 


} VCB; 







next unused file number */ 
number of unused blocks */ 
volume name ■■*/ 
drive number */ 
driver reference number */ 
file system identifier */ 
volume reference number */ 
location of block map */ 
location of volume buffer */ 
number of bytes in block map 
used internally */ 
used internally */ 



typedef struct DrvQEl { 
struct QElem *qLink; 
short qType : 
short dQDrive; 
short dQRefNum; 
short dQFSID; 
short dQDrvSize; 

) DrvQEl, *DrvQElPtr; 



/* 
/* 
/* 
/* 
/* 
/* 



next queue entry */ 

not used */ 

drive number *./ 

drive reference number */ 

file system identifier */ 

number of logical blocks */ 



/* High-Level Routines 



*/ 



/* Accessing Volumes */ 

OSErr GetVInfo(drvNum, volName, vRefNum, freeBytes) 

short drvNum; 

char *volName; 

short *vRefNum; 

long *freeBytes; 
OSErr GetVol (volName,vRefNum) 

char *volName; 

short *vRefNum; 
OSErr SetVol (volName, vRefNum) 

char *volName; 

short vRefNum; 
OSErr F lu sh Vol (volName, vRefNum) 

char *volName; 

short vRefNum; 
OSErr UnmountVol (volName, vRefNum) 

char *volName; 

short vRefNum; 
OSErr Eject (volName, vRefNum) 

char *volName; 

short vRefNum; 



/* Changing File Contents */ 

OSErr Create (fileName,vRefNum, creator, filetype) 
char *fileName; 
short vRefNum; 
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OSType creator, fileType; 
OSErr FSOpen(f ileName, vRefNum, refNum) 

char *f ileName; 

short vRefNum, *refNum; 
OSErr OpenRF (f ileName, vRefNum, refNum) 

char *f ileName; 

short vRe f Num , * re f Num ; 
OSErr FSRead(refNum,count,buffPtr) 

short refNum; 

long *count; 

Pt'r buffPtr; 
OSErr FSWrite (refNum, count, buffPtr) 

short refNum; 

long *count; 

Ptr buffPtr; 
OSErr GetFPos (refNum, filePos) 

short refNum; 

long *filePos; 
OSErr SetFPos (refNum/posMode,posOff ) 

short refNum, posMode; 

long posOff ; 
OSErr GetEOFf refNum, logEOF) 

short refNum; 

long *logEOF; 
OSErr SetEOF (refNum, logEOF) 

short refNum; 

long logEOF; 
OSErr Allocate (refNum, count) 

short refNum; 

long *count; 
OSErr GetVRef Num (pathRefNum, vRef Num) 

short pathRefNum; 

short *vRefNum; 
OSErr FSClose (refNum) 

short refNum; 



/* Changing Information About Files */ 

OSErr GetFInf o (f ileName, vRef Num, f ndrlnf o) 

char *f ileName; 

short vRefNum; 

FInfo * f ndrlnf o; 
OSErr SetFInf o (f ileName, vRefNum, f ndrlnf o) 

char *fileName; 

short vRefNum; 

FInfo *f ndrlnf o; 
OSErr SetFLock (f ileName, vRef Num) 

char * f i leName ; 

short vRefNum; 
OSErr RstFLock (f ileName, vRef Num) 

char *f ileName; 

short vRefNum; 
OSErr Rename (oldName, vRefNum, newName) 

char *oldName; 

short vRefNum; 

char *newNarne; 
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OSErr FSDelete (f ileName, vRefNum) 
char *f ileName ; 
short vRefNum; 



/* Low-Level Routines • */ 



void FInitQueue() 

void AddDrive (drvrRefNum,drvNum,qEl) ; 

short drvrRefNum, drvNum; 

drvQElPtr qEL; 



/* Accessing Volumes */ 

OSErr PBMountVol (paramBlock) 

VolumeParam *paramBlock; 
OSErr PBGetVInf o (paramBlock, async) 

VolumeParam *paramBlock; 

Boolean async; 
OSErr PBGetVol (paramBlock, async) 

VolumeParam *paramBlock; 

Boolean async; 
OSErr PBSetVol (paramBlock, async) 

VolumeParam *paramBlock; 

Boolean async; 
OSErr PBFlushVol (paramBlock, async) 

VolumeParam *paramBlock; 

Boolean async; 
OSErr PBUnmountVol (paramBlock) 

VolumeParam *paramBlock; 
OSErr PBOf f Line (paramBlock) 

VolumeParam *paramBlock; 
OSErr PBE ject (paramBlock) 

VolumeParam *paramBlock; 



/* Changing File Contents */ 

OSErr PBCreate (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBOpen (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBOpenRF (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBRead (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBWrite (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBGetFPos (paramBlock, async) 

IOParam *paramBlock; 
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Boolean async; 
OSErr PBSetFPos (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBGetEOF (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBSetEOF (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBAllocate (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBFlushFile (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBClose (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 



/* Changing Information About Files */ 

OSErr PBGetFInf o (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBSetFInfo (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBSetFLock (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBRstFLock (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBSetFVers (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBRename (paramBlock, async) 

IOParam *paramBlock; 

Boolean async; 
OSErr PBDelete (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 



/* Accessing Queues */ 

struct QHdr *GetFSQHdr() 
struct QHdr *GetVCBQHdr < ) 
struct QHdr *GetDrvQHdr ( ) 



DESCRIPTION 

The File Manager controls the exchange of information between an application and 
files. 
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Warning: The low-level routines that use strings take as input and return as output 
pointers to Pascal-style strings (string length in first byte). However, the high-level 
routines use C-style strings (terminated by a null character) as input and output 
parameters. 

For more detailed information see the File Manager chapter of Inside Macintosh. 

NOTE 

An I/O completion routine cannot reliably access any globals, strings* or other 
functions outside its segment 
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NAME 

fonts — Font Manager 

SYNOPSIS 

♦include <types.h> 
♦include <fonts.h> 



♦define 


systemFont 





♦define 


applFont 


1 


♦define 


newYork 


2 


♦define 


geneva 


3 


♦define 


monaco 


4 


♦define 


venice 


5 


♦define 


london 


6 


♦define 


athens 


7 


♦define 


sanFran 


8 


♦define 


toronto 


9 


♦define 


cairo 


11 


♦define 


losAngeles 


12 


♦define 


times 


20 


♦define 


helvetica 


21 


♦define 


courier 


22 


♦define 


symbol 


23 


♦define 


taliesin 


24 


♦define 


kanji 


25 


♦define 


cammandMark 


'\021 


♦define 


checkMark 


'\022 


♦define 


diamondMark 


'\023 


♦define 


appleMark 


'\024 



♦define propFont 0x9000 
♦define fixedFont OxBOOO 
♦define fontwid OxACBO 



typedef struct FMInput { 



short 


family; 


short 


size; 


Style 


face; 


Boolean 


needBits; 


short 


device; 


Point 


numer; 


Point 


denom; 


} FMInput; 





typedef struct FMOutput { 
short errNum; 
Handle fontHandle; 
unsigned char boldPixels; 
unsigned char italicPixels; 
unsigned char ulOffset; 
unsigned char ulShadow; 
unsigned char ulThick; 
unsigned char shadowPixels; 
char extra; 
unsigned char ascent; 



/* e.g. New York */ 

/* e.g. 12 Point */ 

/* e.g. bold I underline */ 

/* bits or just measurement */ 

/* always for display */ 

/* current drawing scale */ 

/* current drsiwing scale */ 



/* not used */ 

/* Handle to font */ 

/* pixels of horizontal smear */ 

/* pixels of horizontal shear */ 

/* pixels below baseline */ 

/* pixels in halo */ 

/* thickness of underline */ 

/* pixels to shadow (0 . . 3) */ 

/* extra white pixels/char */ 

/* ascent */ 
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unsigned char descent ; 


/* 


descent */ 


unsigned char widMax; 


/* 


maximum character width */ 


char leading; 


/* 


leading between lines */ 


char unused; 


/* 


not used */ 


Point numer; 


/* 


current drawing scale */ 


Point denom; 


/* 


current drawing scale */ 


) FMOutput, *FMOutPtr; 






typedef struct FontRec { 






short font Type; 


/* 


font type */ 


short f irstChar; 


/* 


ASCII code of first character */ 


short lastChar; 


/* 


ASCII code of last character */ 


short widMax; 


7* 


maximum character width */ 


short kernMax; 


/* 


negative of maximum character kern */ 


short nDescent; 


/* 


negative of descent */ 


short fRectWidth; 


/* 


width of font rectangle */ 


short fRectHeight; 


/* 


height of font rectangle */ 


short owTLoc; 


/* 


offset to offset/width table */ 


short ascent; 


/* 


ascent */ 


short descent; 


/* 


descent */ 


short leading; 


/* 


leading */ 


short rowWords; 
/* 


/* 


row width of bit image / 2 */ 


r\W"lo. 


.1 U1 1 r (fDanfUsi rrU*- — 1 * 4.1 1 ■ 


short locTable[ (lastChar+2-f irstChar) +1] ; 


short owTable [ (lastChar+2-f irstChar) +1] ; 
*/ 


} FontRec; 






pascal void InitFonts() 






void GetFdntName (fontNum, theName) 




short fontNum; 






char * theName; 






void GetFNum(fontName,theNum) 






char *fontName; 






short *theNum; 






pascal Boolean RealFont (fontNum 


, size) 


short fontNum; 






short size; 






pascal void SetFontLock (lockFlag) 




Boolean lockFlag; 






pascal FMOutPtr SwapFont (inRec) 






FMInput *inRec; 






DESCRIPTION 






The Font Manager supports the character fonts used to draw text with QuickDraw. 


For more detailed information see the Font Manager chapter of Inside 


Macintosh. 
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NAME 



memory — Memory Manager 



SYNOPSIS 

♦include <types-h> 
♦include <memory.h> 

♦define maxSize 0x800000 /* maximum block size */ 



/* Result Codes */ 

♦define memFullErr (-108) 

♦define memLockedErr (-117) 

♦define memPurErr (-112) 

♦define memWZErr (-111) 

♦define nilHandleErr (-109) 
♦define noErr 



/* not enough room in zone */ 

/* block is locked */ _ 

/* attempt to purge a 

/* attempt to operate 

/* nil master pointer 

/* no error */ 



locked block */_ 
on a free block 
*/ 



typedef long Size; 
typedef struct Zone { 



Ptr 


bkLim; 


Ptr 


purgePtr; 


Ptr 


hFstFree; 


long 


zcbFree; 


ProcPtr 


gzProc; 


short 


moreMast; 


short 


flags; 


short 


cntRel; 


short 


maxRel; 


short 


cntNRel; 


short 


maxNRel; 


short 


cntEmpty; 


short 


cntHandles; 


long 


minCBFree; 


ProcPtr 


purgeProc; 


Ptr 


sparePtr; 


Ptr 


allocPtr; 


short 


heapData; 


Zone, *TH 


z; 



/* limit pointer */ 

/* used internally */ 

/.* first free master pointer */ 

/* number of free bytes */ 

/* grow zone function */ 

/* master pointers to allocate */ 

/* used internally */ 

/* relocatable blocks */ 

/* maximum cntRel value */ 

/* nonrelocatable blocks */ 

/* maximum maxRel value */ 

/*' empty master pointers */ 

/* total master pointers */ 

/* minimum zcbFree value */ 

/* purge warning procedure */ 

/* used internally */ 

/* used internally */ 

/* first usable byte in zone */ 



/* Initialization and Allocation */ 

void InitApplZoneO 

void SetApplBase(startPtr) 

Ptr startPtr; 
void InitZone (pGrowProc, cMoreMasters, limitPtr, startPtr) 

ProcPtr pGrowProc; 

short cMoreMasters; 

Ptr limitPtr, startPtr; 
void SetApplLimit (zoneLimit) 

Ptr zoneLimit; 
Ptr GetApplLimit 
void MaxApplZone 
void MoreMastersO 
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/* Heap Zone Access */ 

THz GetZoneO 
void SetZone(hz) 

THz hz; 
THz SystemZone () 
THz ApplicZoneO 



/* Allocating and Releasing Relocatable Blocks */ 

Handle NewHandle (logicalSize) 

Size logicalSize; 
void DisposHandle (h) 

Handle h; 
Size GetHandleSize (h) 

Handle h; 
void SetHandleSize (h,newSize) 

Handle h; 

Size newSize; 
THz HandleZone <h) 

Handle h; 
Handle RecoverHandle (p) 

Ptr p; 
void ReallocHandle (h, logicalSize) 

Handle h; 

Size logicalSize; 



/* Allocating and Releasing Nonrelocatable Blocks */ 

Ptr NewPtr (logicalSize) 

Size logicalSize; 
void DisposPtr(p) 

Ptr p; 
Size GetPtrSize(p) 

Ptr p; 
void SetPtrSize(p, newSize) 

Ptr p; 

Size newSize; 
THz PtrZone (p) 

Ptr p; 

/* Freeing Space ii the Heap */ 

long FreeMemO 
Size MaxMem(grow) 

Size *grow; 
Size CompactMem (cbNeeded) 

Size cbNeeded; 
void Res rvMem (cbNeeded) 

Size cbNeeded; 
void PurgeMem (cbNeeded) 

Size cbNeeded; 
void EmptyHandle (h) 
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Handle h; 



/* Properties of Relocatable Blocks */ 

void HLock(h) 

Handle h; 
void HUnlock(h) 

Handle h; 
void HPurge(h) 

Handle h; 
void HNoPurge(h) 

Handle h; 



/* Grow Zone Operations */ 

void SetGrowZone (growZone) 

ProcPtr growZone; 
Boolean GZCriticalO 
Handle GZSaveHndO 



/* Miscellaneous Routines */ 

BlockMove(sourcePtr,destPtr,byteCount) 

Ptr sourcePtr, destPtr; 

long byteCount; 
Ptr TopMemO 
void MoveHHi (h) 

Handle h; 
OSErr MemError() 



USER ROUTINES 

pascal Size MyGrowZone (cbNeeded) 
Size cbNeeded; 

DESCRIPTION 

The Memory Manager provides dynamic allocation of both relocatable and 
nonrelocatable memory space within the system and application heaps. 

For more detailed information see the Memory Manager chapter of Inside 
Macintosh. 
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NAME 

menus — Menu Manager 

SYNOPSIS 

♦include <types.h> 
♦include <menus.h> 

/* Special Characters */ 

fdefine noMark ' \0' 

/* Messages to Menu Definition Functions */ 

fdefine mDrawMsg 

♦define mChooseMsg 1 
fdefine mSizeMsg 2 

/* Resource ID of Standard Menu Definition Procedure */ 
fdefine textMenuProc 



typedef struct Menulnfo { 
short menuID ; 
short menuWidth; 
short menuHeight; 
ProcHandle menuP roc- 
long enableFlags; 
Str255 menuData; 

} Menulnfo, *MenuPtr, **MenuHandle; 



/* Initialization and Allocation */ 

pascal void InitMenusO 

MenuHandle NewMenu (menuID,menuTitle) 

short menuID; 

char *menuTitle; 
pascal MenuHandle GetMenu(resourcelD) 

short resourcelD; 
pascal void DisposeMenu (theMenu) 

MenuHandle theMenu; 
void AppendMenu (theMenu, data) 

MenuHandle theMenu; 

char *data; 
pascal void AddResMenu (theMenu, theType) 

MenuHandle theMenu; 

ResType theType; 
pascal void InsertResMenu (theMenu, theType, afterltem) 

MenuHandle theMenu; 

ResType theType; 

short afterltem; 



/* Forming the Menu Bar */ 

pascal void InsertMenu (theMenu, beforelD) 
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MenuHandle theMenu; 

short bef ore-ID; 
pascal void DrawMenuBar () 
pascal void DeleteMenu (menuID) 

short menuID; 
pascal void ClearMenuBar () 
pascal Handle GetNewMBar (menuBarlD) 

short menuBarlD; 
pascal Handle GetMenuBarO 
pascal void SetMenuBar (menuList) 

Handle menuList; 



/*' Choosing From a Menu */ 

long MenuSelect (startPt) 

Point * startPt; 
pascal long MenuKey(ch) 

short ch; 
pascal void HiliteMenu (menuID) 

short menuID; 



/* Controlling Items' Appearance */ 

void Setltem (theMenu, item, itemString) 

MenuHandle theMenu ; 

short item; 

char *itemString; 
void Getltem (theMenu, item, itemString) 

MenuHandle theMenu; 

short item; 

char *itemString; 
pascal void Disableltem (theMenu, item) 

MenuHandle theMenu; 

short item; 
pascal void Enableltem (theMenu, item) 

MenuHandle theMenu; 

short item; 
pascal void Checkltem (theMenu, item, checked) 

MenuHandle theMenu; 

short item; 

Boolean checked; 
pascal void SetltemMark (theMenu, item, markChar) 

MenuHandle theMenu; 

short item; 

short markChar; 
pascal void GetltemMark (menu, item, markChar) 

MenuHandle menu; 

short item; 

short *markChar; 
pascal void Setltemlcon (theMenu, item, iconNum) 

MenuHandle theMenu; 

short item; 

short iconNum; 
pascal void Get ItemI con (theMenu, item, iconNum) 

MenuHandle theMenu; 
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short item; 

short *iconNum; 
pascal void Set ItemStyle (theMenu, item, chStyle) 

MenuHandle theMenu; 

short item; 

Style chStyle; 
pascal void GetltemStyle (menu, item, chStyle) 

MenuHandle menu; 

short item; 

Style *chStyle; 

/* Miscellaneous Utilities */ 

pascal void CalcMenuSize (theMenu) 

MenuHandle theMenu; 
pascal short CountMItems (theMenu) 

MenuHandle theMenu; 
pascal MenuHandle GetMHandle (menuID) 

short menu ID; 
pascal void FlashMenuBar (menuID) 

short menu ID ; 
pascal void SetMenuFlash (count) 

short count; 



USER ROUTINES 

pascal void MyMenu (message, theMenu,menuRect,hitPt, whichltem) 
short message; 
MenuHandle theMenu; 
Rect *menuRect; 
Point hitPt; 
short *whichltem; 

DESCRIPTION 

The Menu Manager provides routines for creating and using menus. 

Warning: The names of desk accessories start with a null byte. The output 
parameter from GetMenuItem will return a string that begins with a null byte when 
a desk accessory is selected from the Apple menu. OpenDeskAcc skips over the 
null byte when interpreting its parameter. 

For more detailed information see the Menu Manager chapter of Inside 
Macintosh. 
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NAME 

osevents — Operating System Event Manager 

SYNOPSIS 

♦include <types.h> 
♦include <osevents.h> 



typedef struct EvQEl { 


struct 


QElem *qLink; 


short 


qType; 


short 


evtQWhat ; 


long 


evtQMessage; 


long 


evtQWhen; 


Point 


evtQWhere; 


short 


evtQModif iers ; 


} EvQEl; 





/* Setting the System Event Mask */ 

void SetEventMask(theMask) 
short theMask; 



/* Posting and Removing Events ■*/ 

OSErr PostEvent (eventCode, eventMsg) 

short eventCode; 

long eventMsg; 
void FlushEvents (eventMask, stopMask) 

short eventMask; 

short stopMask; 



/* Accessing Events */ 

Boolean GetOSEvent (eventMask, theE vent) 

short eventMask; 

struct EventRecord *theEvent; 
Boolean OSEventAvail (eventMask, theEvent) 

short eventMask; 

struct EventRecord *theEvent; 



/* Directly Accessing the Event Queue */ 
struct QHdr *GetEvQHdr() 

DESCRIPTION 

The Operating System Event Manager provides a low-level interface to the 
Macintosh keyboard, keypad, and mouse. 

For more detailed information see the Operating System Event Manager chapter of 
Inside Macintosh. 
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osutils — Operating System Utilities 






SYNOPSIS 








♦include <types.h> 








♦include <osutils.h> 








#define noErr 





/* 


no error */ 


#define qErr 


(-D 


/* 


element not in specified queue */ 


#define clkRdErr 


(-85) 


/* 


unable to read clock */ 


#define clkWrErr 


(-86) 


/* 


time written did not verify */ 


♦define prWrErr 


(-87) 


/* 


parameter RAM written did not verify */ 


#define prlnitErr 


(-88) 


/* 


validity status is not 0xa8 */ 


♦define memFullErr 1 


-108) 


/* 


not enough room in heap */ 


tdefine nilHandleErr ( 


-109) 


/* 


nil master pointer */ 


#define memWZErr I 


-111) 


/* 


attempt to operate on a free block */ 


/* Serial Port configura 


tion constants for config field of SysParmType */ 


fdefine useFree 





/* 


use undefined */ 


fdefine useATalk 


1 


/* 


AppleTalk ■■*/ 


fdefine useAsync 


2 


/* 


Async */ 


/* Machine type returned 


by "Environs" routine */ 


♦define macXLMachine 





/* 


Macintosh XL (a.k.a. Lisa) */ 


♦define macMachine 


1 


/* 


Macintosh */ 


/* typedef long OSType; 


appears 


in file TYPES */ 


/* typedef short OSErr; 


appears 


in file TYPES */ 


typedef struct SysParmType { 






char valid; 




/* 


validity status */ 


char aTalkA; 




/* 


AppleTalk node # hint for port A */ 


char aTalkB; 




/* 


AppleTalk node # hint for port B */ 


char config; 




/.* 


AppleTalk serial port configuration */ 






/* 


port A - bits 4-7, B = bits 0-3 */ 


short port A; 




/* 


modem port configuration */ 


short portB; 




/* 


printer port configuration */ 


long alarm; 




/* 


alarm setting ■*/ 


short font; 




•/* 


default application font number - 1 */ 


s ho rt kbdP r int ; 




/* 


auto-key threshold and rate, printer */ 






/* 


connection */ 


short volClik; 




/* 


speaker volume, double-click and */ 






/* 


caret-blink times */ 


short misc; 




/* 


mouse scaling, system startup disk, */ 






/* 


menu blink */ 


} SysParmType, *SysPPtr; 








typedef struct QElem { 








struct QElem *gLin 


k; 


/* 


next queue entry */ 


short OfType 


/ 


/* 


queue type */ 


short qData 


[0]; 


/* 


queue type specific data */ 


} QElem, *QElemPtr; 
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typedef struct 


QHdr 


short 


qFlags 


QElemPtr 


qHead; 


QElemPtr 


qTail; 


} QHdr, *QHdrPtr; 


typedef enum 


{ 


dummyType, 




vType, 




ioQType, 




drvQType, 




evType, 




fsQType 




} QTypes; 




typedef struct DateTime 


short 


year; 


short 


month; 


short 


day; 


short 


hour; 


short 


minute ; 


short 


second; 


short 


dayOfWeek 



/* queue flags */ 

/* first queue entry */ 

/* last queue entry */ 



/* vertical retrace queue type */ 

/* file I/O or driver I/O type */ 

/* drive queue type */ 

/* event queue type */ 

/* volume-control-block queue type 



/* four-digit year */ . 

/* 1 to 12 for January to December */ 

/* 1 to 31 */ 

/* ' to 23 */ 

/* ' to 59 */ 

/* ■ to 59 */ 

7* to 7 for Sunday to Saturday */ 



} DateTimeRec; 



/* Pointer and Handle Manipulation *y 

OSErr HandToHand(theHndl) 

Handle *theHndl; 
OSErr PtrToHand(srcPtr,dstHndl/ size) 

Ptr srcPtr; 

Handle *dstHndl; 

long size; 
OSErr PtrToXHand (srcPtr, dstHndl, size) 

Ptr srcPtr; 

Handle dstHndl; 

long size; 
OSErr HandAndHand(aHndl,bHndl) 

Handle aHndl/bHndl; 
OSErr PtrAndHand(pntr,hndl,size) 

Ptr pntr; 

Handle hndl; 

long size; 



/* String Comparison */ 

Boolean EqualString (aStr, bStr, caseSens, diacSens 

char *aStr,*bStr; 

Boolean caseSens, diacSens; 
void UprString(theString, diacSens 

char *theString; 
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Boolean marks; 



/* Date and Time Operations */ 

OSErr ReadDateTime (sees) 

long *secs; 
void GetDateTime (sees) 

long *secs; 
OSErr SetDateTime(secs) 

long sees; 
void Date2Secs (date, sees) 

DateTimeRec Mate; 

long *secs; 
void Secs2Date( sees, date) 

long sees; 

DateTimeRec *date; 
void GetTime (date) 

DateTimeRec *date; 
void SetTime (date) 

DateTimeRec Mate; 



/* Parameter RAM Operations */ 

OSErr InitUtiK) 
SysPPtr GetSysPPtrO 
OSErr WriteParamO 



/* Queue Manipulation */ 

void Enqueue (qElement, theQueue) 

QElemPtr qElement; 

QHdrPtr theQueue; 
OSEr r Dequeue (qElement , theQueue) 

QElemPtr qElement; 

QHdrPtr theQueue; 



/* Dispatch Table Utilities */ 

void SetTrapAddress (trapAddr,trapNum) 

long trapAddr; 

short trapNum; 
long GetTrapAddress (trapNum) 

short trapNum; 



/* Miscellaneous Utilities */ 

void Delay (numTickSffinalTicks) 
long numTicks, *finalTicks; 

pascal void SysBeep (duration) 
short duration; 

void Environs (rom r machine) 
short *rom, *machine; 
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void Restart () 

DESCRIPTION 

The Operating System Utilities are a set of routines and data types in the Operating 
System that perform generally useful operations such as manipulating pointers and 
handles, comparing strings, and reading the date and time. 

For more detailed information see the Operating System Utilities chapter of Inside 
Macintosh. 
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NAME 

packages — 

Package Manager, Disk Initialization, Standard File Package, International Utilities, 
Binary-Decimal Conversion 

SYNOPSIS 

♦include <types.h> 
♦include <packages.h> 



/* Package Manager 



*/ 



/* Resource IDs for packages */ 



♦define dsklnit 


2 


/* 


♦define stdFile 


3 


/* 


♦define flPoint 


4 


/* 


♦define trFunc 


5 


/* 


♦define intUtil 


6 


/* 


♦define bdConv 


7 


/* 



Disk Initializaton */ 
Standard File */ 
Floating-Point Arithmetic */ 
Transcendental Functions */ 
International Utilities */ 
Binary/Decimal Conversion */ 



pascal void InitAllPacks {) 
pascal void InitPack(packlD) 

short packID; 



/* Disk Initialization Package 

void DILoadO 

void DIUnLoadO 

short DIBadMount (where/ evtMessage) 

Point where; 

long evtMessage; 
OSErr DIFormat (drvNum) 

short drvNum; 
OSErr DIVerify(drvNum) 

short drvNum; 
OSErr DIZero {drvNum, volName) 

short drvNum; 

char *volName; 



/* Standard File Package 



♦define putDlgID (-3999) /.* SFPutFile dialog template ID */ 



♦define putSave 1 

♦define putCancel 2 

♦define putEject 5 

♦define putDrive 6 

♦define putName 7 

♦define getDlgID (-4000) 

♦define getopen 1 

♦define getCancel 3 

♦define getEject 5 



/* Save button */ 
■•/* Cancel button */ 
/* Eject button */ 
/* Drive button */ 
/* editTExt item for file name */ 

/* SFGetFile dialog template ID */ 

/* Open button */ 
/* Cancel button */ 
/* Eject button */ 



Page 109 



Ex Libris • David T Craig • August 2009 



Page 01 17 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 
PACKAGES Macintosh Interface Libraries PACKAGES 



#define getDrive 6 /* Drive button */ 

#define, getNmLis.t 7 /* userltem for file name list */ 

fdefine getScroll 8 /* userltem for scroll bar */ 

typedef struct SFReply { 

Boolean good; /* FALSE if ignore command ■*/ 

Boolean copy; /* not used */ 

OSType fType; /* file type or not used */ 

short vRefNum; /* volume reference number */ 

short version; /* file's version number */ 

String(63) fName; /* file name */ 

} SFReply ; 

typedef OSType SFTypeList [4] ; 

void SFPutFile (where , prompt , or igName , dlgHook , reply) 

Point *where; 

char *proiapt; 

char *or igName; 

ProcPtr dlgHook; 

SFReply * reply; 
void SFPPutFile (where, prompt, origName, dlgHook, reply, dlglD, filterProc) 

Point *where; 

char *prompt; 

char *origName; 

ProcPtr dlgHook; 

SFReply * reply; 

short dlglD; 

ProcPtr filterProc; 
void SFGetFile (where, prompt , f ileFilter,mimTypes, typeList, dlgHook, reply) 

Point *where; 

char *prompt; 

ProcPtr fileFilter; 

short numTypes; 

SFTypeList typeList; 

ProcPtr dlgHook ; 

SFReply * reply; 
void SFPGetFile (where, prompt, f ileFilter, numTypes, typeList, dlgHook, reply, 
dlglD, filterProc) 

Point * where ; 

char *prompt; 

ProcPtr fileFilter; 

short numTypes; 

SFTypeList typeList; 

ProcPtr dlgHook; 

SFReply * reply; 

short dlglD; 

ProcPtr filterProc; 



/* International Utilities Package 
/* Masks for currency format */ 



#define currSymLead 16 /* set if currency symbol leads */ 
♦define currNegSym 32 /* set if minus sign for negative */■ 
#define currTrailingZ 64 /* set if trailing decimal zeroes */ 
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♦define currLeadingZ 128 


/* set if leading integer zeroes */ 


/* Order of short date elements */ 


♦define mdy ° 


/* month day year */ 


♦define dmy 1 


/* day month year */ 


♦define ymd 2 


/* year month day */ 


/* Masks for short date format */ 


♦define dayLdingZ 32 


/* set if leading zero for day */ 


♦define mntLdingZ 64 


/* set if leading zero for month */ 


♦define century 128 


/* set if century included */ 


/* Masks for time format * 


/ 


♦define secLeadingZ 32 


/* set if leading zero for seconds */ 


♦define minLeadingZ 64 


/* set if leading zero for minutes */ 


♦define hrLeadingZ 128 


/* set if leadincr zero for hours */ 

1 


/* Country Codes — high-o 


rder byte of version information */ 


♦define verUS 




♦define verFrance 1 




♦define verBritain 2 




♦define verGermany 3 


% 


♦define verltaly 4 




♦define verNetherlands 5 




♦define verBelgiumLux 6 




♦define verSweden 7 




♦define verSpain 8 




♦define verDenmark 9 




♦define verPortugal 10 




♦define verFrCanada 11 




♦define verNorway 12 




♦define verlsrael 13 




♦define ver Japan 14 




♦define verAustralia 15 




♦define verArabia 16 




♦define verFinland 17 




♦define verFrSwiss 18 




♦define verGrSwiss 19 




♦define verGreece 20 




♦define verlceland 21 




♦define verMalta 22 




♦define verCyprus 23 




♦define verTurkey 24 




♦define verYugoslavia 25 




typedef struct IntlORec { 




char decimalPt; 


/* decimal point character */ 


char thousSep; 


/* thousands separator */ 


char listSep; 


/* list separator */ 


char currSyml; 


/* currency symbols (3 bytes long) */ 


char currSym2; 




char currSym3; 




unsigned char currFmt; 


/* currency format ■*/ 
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unsigned: char dateOrder; /* short date order - dmy, ymd or mdy */ 


unsigned char shrtDateFmt; /* short date format */ 


char dateSep; ./* date separator */ 


unsigned char timeCycle; /* if 24-hour cycle, 255 if 1- hour */ 


unsigned char timeFmt; /* time format */ 


char mornStr[4] ; /* trailing string for first 12 hours */ 


char eveStr[4]; /* trailing stringfor last 12 hours */ 


char timeSep; /* time separator */ 


char timelSuff; /* trailing string for 24-hour cycle */ 


char time2Suff; 


char time3Suf:f ; 


char tirae4Suff; 


char time5Suff.; 


char time6Suff; 


char time7Suff; 


char timefrSuff; 


.unsigned char ' •metricSys; /* 255 for metric, if not */ 


short intlOVers; /* version information - country, vers */ 


} IntlORec, *IntlOPtr, **IntlOHndl; 


typedef struct IntllRec { 


String(15) days [7]; /* day names */ 


String(15) months [12]; /* month names */" 


unsigned char suppressDay; /* for day name, 255 for none */ 


unsigned char IngDateFmt; /* order of long date elements */ 


unsigned'char dayLeadingO; /* 255 for leading in day number */ 


unsigned char abbrLen; /* length for abbreaviating names */ 


char st0[4]; /* date punctuation */■ 


char stl[4]; 


char st2 [4] ; 


char st3[4]; 


char st4 [4] ; 


short intllVers; /* version information */ 


short looalRtnfO] ; /* routine for string conparison */ 


} IntllRec, *IntllPtr, **IntllHndl; 


typedef enum {shortDate, longDate,abbrevDate} DateForm; 


void IUDateString (dateTime, form, result) 


long dateTime; 


DateForm form; 


. char * resu.lt; 


void IUDatePString (dateTime, form, result, intlParam) 


long dateTime; 


DateForm form; 


char * result; 


Handle intlParam; 


void IUTimeString (dateTime, wantSeconds, result) 


long dateTime; 


Boolean wantSeconds; 


char *result; 


void IUTimePString (dateTime, wantSeconds, result, intlParam) 


long dateTime; 


Boolean wantSeconds; 


char *result; 


Handle intlParam; 


Boolean IUMetricO 
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Handle IUGetlntl (thelD) 

short the ID ; 
void IUSetlntl (refNum, thelD, intlParam) 

short refNum; 

short thelD; 

Handle intlParam; 
short IUCompString(aStr,bStr) 

char *aStr; 

char *bstr; 
short IUMagString(aPtr,bPtr,aLen,bLen) 

Ptr aPtr,bPtr; 

short aLen,bLen; 
short IUEgualString(aStr,bStr) 

char *aStr; 

char *bStr; 
short IUMagIDString(aPtr,bPtr,aLen,bLen] 

Ptr aPtr,bPtr; 

short aLen,bLen; 



/* Binary-Decimal Conversion Package 

void StringToNum (theString, theKfum) 

char *theString; 

long *theNum; 
void NumToString (theNum, theString) 

long theNum; 

char *theString; 



USER ROUTINES 

/* Standard File Package 



short MyDlg(item,theDialog). 
short item; 
DialogPtr theDialog; 

Boolean MyFileFilter (paramBlock) 

ParmBlkPtr paramBlock; 

DESCRIPTION 

The Package Manager provides for the initialization of packages. 

For more detailed information see the following chapters of Inside Macintosh: 
Package Manager, Disk Initialization Package, Standard File Package, International 
Utilities Package, Binary-Decimal Conversion Package. 
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NAME 

printing — Printing Manager 

SYNOPSIS 

♦include <types . h> 
♦include <quickdraw.h> 
♦include <printing.h> 



/* Printing Methods */ 

♦define bDraftLoop 
♦define bSpoolLoop 



/* draft printing */ 

1 /* spooling */ 



/* Printer specification in prStl field of print record */ 



♦define bDevCItoh 
♦define bDevLaser 



1 /* ImageWriter printer */ 
3 /* LaserWriter printer */ 



/*■ Maximum nHISfet? of pages in a spool file */ 



♦define iPFMaxPgs 

♦define iPrPgFract 

/* Result codes */ 

♦define noErr 

♦define iPrSavPFil 

♦define ilOAbort 

♦define iMemFullErr 

♦define iPrAbort 



128 /* max pages in a spool file */ 
120 /* paper units per inch */ 



7* no error */ 

(-1) /* saving spool file */ 

(-27) /* I/O abort error */ 

(-108) /* not enough room in heap zone */ 

128 /* application or user requested abort */ 



/* Printer Driver Control Call Parameters *./ 



♦define 


iPrDevCtl 


7 


/* 


device control */ 


♦define 


lPrReset 


0x00010000 


/* 


reset printer */ 


♦define 


IP r Linefeed 


0x00030000 


/* 


start new line */ 


♦define 


IP rL? Sixth 


0x0003FFFF 


/* 


standard 1/6" line feed */ 


♦define 


lPrPageEnd 


0x00020000 


/* 


start new page */ 


♦define 


iPrBitsCtl 


4 


/* 


bit map printing */ 


♦define 


IScreenBits 





/* 


configurable */ 


♦define 


lPaintBits 


1 


/* 


72 x 72 dots */ 


♦define 


iPrlOCtl 


5 


/* 


text streaming */ 



/* Printing Resources */ 

♦define sPrDrvr 
♦define iPrDrvrRef 



.Print™ /* Printer Driver resource name */ 
(-3) /* Printer Driver reference number */ 



/* Type definitions */ 

typedef Rect *TPRect; 

typedef struct TPrPort { 
Graf Port gPort; 



/*' graph port to draw in */ 
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QDProcs 


gProcs; /* pointers to drawing routines */ 


long 
long 
long 
long 
Boolean 


lGParaml; /* internal ■■*/ 


lGParam2; /* internal ■■*/ 


lGParam3; /* internal */ 


lGParam4; /* internal ■■*/ 


fOurPtr; /* internal */ 


Boolean 


fOurBits; /* internal */ 


} TPrPort, 


*TPPrPort; 


typedef struct TPrlnfo { 


short 


iDev; /* printer information */ 


short 


iVRes; /* printer vertical resolution */ 


short 


iHRes; /* printer horizontal resolution ■*/ 


Rect 


rPage; /* page rectancrle */ 


} TPrlnfo; 




typedef enum (feedCut, feedFanfold, feedMechCut, feedOther} TFeed; 


typedef struct TPrStl * 


short 


wDev ' * high byte specifies device */ 


short 


iPageV; /* paper height */ 


short 


iPageH; /* P a P er width */ 


char 


bPort; 1* printer or modem port - ignored */ 


TFeed 


feed;' /* P a P©r type */ 


} TPrStl; 




typedef enum {scanTB,scanBT,scanLR,scanRL} TScan; 


typedef struct TPrXInf o [ . _ 


short 


iRowBytes; ' b ¥ tes Per row */ 


short 


iBandV; 1* vertical dots */ 


short 


iBandH- /* horizontal dots ■■*/ 


short 


iDevBytes; /* size of bit image */ 


short 


iBands; ' /* bands per page */ 


char 


bPatScale; /* used b Y QuickDraw *•/ 


char 


bUlThick- ^* underline thickness *■/ 


char 


bUlOffset; /* underline offset */ 


char 


bUlShadow; /* underline descender */ 


TScan 


scan; ' 1* scan direction */ 


char 


bXInfoX; /* not used */ 


} TPrXInfo; 


. 


typedef struct TPrJob {-.."_. 


short 


iFstPage; ' first page to print */ 


short 


iLstPage; '* iast P a< 3 e to P rlnt *■/ 


short 


iCopies; /* number of copies */ 


char 


bJDocLoop; 1* Printing method*/ 


Boolean 


fFromUsr- /* true i f called from application */ 


ProcPtr 


pldleProc; /* background procedure , ■*/ 


StringPt 


r pFileName; /* s P° o1 file name *' ??? 


short 


iFileVol- /*■ volume reference number */ 


char 


bFileVers; f* version number of spool file */ 


char 


bJobX: * /* not used */ 


} TPrJob; 




typedef struct TPrint { 


short 


iPrVersion; /* Printing Manager version */ 
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TPrlnfo prlnfo; 
Rect r Paper; : 
TPrStl prStl; 
TPrlnfo prlnfoPT; 
TPrXInfo prXInfo; 
TPrJob prJob; 



/* printing information 

/* paper rectangle */ 

/* style information */ 

/* copy of prlnfo */ 

/* band information */ 

/* job information */ 



short printX[19] ■/* internal */ 
} TPrint, *TPPrint, **THPrint; 



typedef struct TPrStatus 



short 

short 

short 

short 

short 

short 

Boolean 

Boolean 

THPrint 



iTotPages; 
iCurPage ; ; 
iTotCopies; 
iCurCopy; 
iTotBands ; 
iCurBand; 
fPgDirty; 
f Imaging; 
hPrint; 



TPPrPort pPrPort; 
PicHandle hPic; 
TPrStatus; 



{ 

/•* 
/* 
/* 
/* 
/*' 
/* 
/* 
/* 
/* 
/■*■ 
/* 



total number of pages */ 

page being printed */ 

number of copies */ 

copy begin printed */ 

bands per page */ 

band being printed */ 

true if started printing page */ 

true if imaging */ 

print record */ 

printing port */ 

internal *./ 



/* Initialization and Termination */ 

pascal void PrOpenO 
pascal void PrCloseO 

/* Print Records and Dialogs ■*/ 

pascal void PrintDefault (hPrint) 

THPrint hPrint; 
pascal Boolean PrValidate (hPrint) 

THPrint hPrint; 
pascal Boolean PrStlDialog (hPrint) 

THPrint hPrint; 
pascal Boolean PrJobDialog (hPrint) 

THPrint hPrint; 
pascal void PrJobMerge (hPrint.Src,hPrintDst) 

THPrint hPrintSrc r hPrintDst; 

/* Document Printing */ 

pascal TPPrPort PrOpenDoc (hPrint, pPrPort, pIOBuf ) 

THPrint hPrint; 

TPPrPort pPrPort; 

Ptr pIOBuf ; 
pascal void PrCloseDoc(pPrPort) 

TPPrPort pPrPort; 
pascal void PirOpenPage (pPrPort,pPageFrame) 

TPPrPort pPrPort; 

TPRect pPagePrame; 
pascal void PrClosePage (pPrPort) 

TPPrPort pPrPort; 

/* Spool Printing */ 
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pascal void PrPicFile (hPrint,pPrPort,pIOBiif ,pDevBuf ,prstatus) 
THPrint hPrint; 
TPPrPort pPrPort; 
Ptr pIOBuf,pDevBuf; 
TPrStatus *prStatus; 

/* Handling Errors */ 

pascal short PrErrorO 
pascal void PrSetError (iErr) 

short - iRrr: 

/* Low Level Driver Access */ 

pascal void PrDrvrOpenO 
pascal void PrDrvrClose () 

pascal void PrCtlCall (iWhichCtl, lParaml, lParam2,lParam3) 
short iWhichCtl; 
* long lParaml, lParam2, lParam3; 
pascal Handle PrDrvrDCEO 
pascal short PrDrvrVers () 



DESCRIPTION 

The Printing Manager supports printing on a variety of devices. 

For more detailed information see the Printing Manager chapter of Inside 
Macintosh. 



NOTE 



The current Pascal implementation has additional constants and data types that 
aren't documented in Inside Macintosh because they're not generally used. 
This interface follows Inside Macintosh . 

Programs that call the high-level printing routines must be linked with object file 
prlink.obj. Programs that call the low-level driver routines must link with 
prscreen.obj. Linking with both files yields duplicate definitions. Therefore a 
program can't call both the high-level routines and the driver routines. 
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NAME 








quickdraw — QuickDraw 






SYNOPSIS 








♦include 


<types . h> 






♦include 


<quickdraw . h> 






/* 16 Transfer Modes * 


/ 




♦define 


srcCopy 







♦define 


srcOr 


i 




♦define 


srcXor 


2 




♦define 


sreBic 


3 




♦define 


not SrcCopy 


4 




♦define 


notSrcOr 


5 




♦define 


notSrcXor 


6 




♦define 


notSrcBic 


7 




♦define 


patCopy 


8 




♦define 


patOr 


9 




♦define 


patXor 


10 




♦define 


patBic 


11 




♦define 


notPatCopy 


12 




♦define 


notPatOr 


13 




♦define 


notPatXor 


14 




♦define 


notPatBic 


15 




/* QuickDraw Color Sep 


aration 


Constants */ 


♦define 


normalBit 







♦define 


inverseBit 


1 




♦define 


redBit 


4 


/* RGB Additive Mapping */ 


♦define 


greenBit 


3 




♦define 


blueBit 


2 




♦define 


cyanBit 


8 


/* CMYBk Subtractive Mapping */ 


♦define 


magentaBit 


7 




♦define 


yellowBit 


6 




♦define 


blackBit 


5 




♦define 


blackColor 


33 


/* Colors Expressed in these Mappings */ 


♦define 


whiteColor 


30 




♦define 


redColor 


205 




♦define 


greenColor 


341 




♦define 


blueColor 


409 




♦define 


cyanColor 


273 




♦define 


magentaColor 


137 




♦define 


yellowColor 


69 




/* Picture Comments */ 






♦define 


picLParen 







♦define 


picRParen 


1 




/* Type 


style Constant 


3 '*/' 




♦define 


normal 


0x00 




♦define 


bold 


0x01 




♦define 


italic 


0x02 




♦define 


underline 


0x04 
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♦define 


outline 


0x08 


#def ine 


shadow 


0x10 


♦define 


condense 


0x20 


♦define 


expand 


0x40 


/'* Types 


*/ 





typedef unsigned char Pattern [8] ; 

typedef short Bitsl6[16]; 

typedef enum {frame, paint, erase, invert, fill} GrafVerb; 

/* typedefs Style, Point, and Rect appear in file TYPES */ 

typedef struct Fontlnfo { 

short ascent; 

short. descent; 

short widMax; 

short leading; 
} Fontlnfo; 

typedef struct BitMap { 

Ptr baseAddr; 

short rowBytes; 

Rect bounds ; 
} BitMap; 

typedef struct Cursor { 

Bits 16 data; 

Bitsl6 mask; 

Point hotSpot; 
} Cursor; 

typedef struct PenState { 

Point pnLoc; 

Point pnSize; 

short pnMode; 

Pattern pnPat; 
} PenState; 

typedef struct Region { 

short rgnSize; 

Rect rgnBBox; 

short rgnData[0]; 
} Region, *RgnPtr, **RgnHandle; 

typedef struct Picture { 

short picSize; 

Rect picFrame; 

short picData [ ] ; 
} Picture, *PicPtr, **PicHandle; 

typedef struct Polygon { 

short polySize; 

Rect polyBBox; 

Point polyPoints [0] ; 
} Polygon, *PolyPtr, **PolyHandle; 
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typedef struct QDProcs { 




ProcPtr 


textProc; 




ProcPtr 


lineProc; 




ProcPtr 


rectProc; 




ProcPtr 


rRectProc; 




ProcPtr 


ovalProc; 




ProcPtr 


arcProc; 




ProcPtr 


polyProc; 




ProcPtr 


rgnProc; 




ProcPtr 


bitsProc; 




ProcPtr 


commentProc; 




ProcPtr 


txMeasProc; 




ProcPtr 


getPicProc; 




ProcPtr 


putPicProc; 




} QDProcs, 


*QDProcsPtr; 




typedef struct GrafPort { 




short 


device ; 




BitMap 


portBits; 




Rect 


portRect; 




RgnHandle visRgn; 




RgnHandl 


e clipRgn; 




Pattern 


bkPat; 




Pattern 


fillPat; 




Point 


pnLoc ; 




Point 


pnSize; 




short 


pnMode ; 




Pattern 


pnPat ; 




short 


pnVis; 




short 


txFont ; 




Style 


txFace; 




short 


txMode ; 




short 


txSize; 




long 


spExtra; 




long 


fgColor; 




long 


bkColor; 




short 


colrBit; 




Short 


patStretch; 




PicHandle picSave; 




RgnHandle rgnSave ; 




PolyHandle polySave; 




QDProcsPtr grafProcs; 




} GrafPort, 


*GrafPtr; 




/* External 


Variable Declarations */ 




extern struct qd { 




char 


private [78] ; 




long 


randSeed; 




BitMap 


screenBits; 




Cursor 


" arrow; 




Pattern 


dkG^ay; 




Pattern 


ltGray; 




Pattern 


gray; 




Pattern 


black; 
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Pattern 
GrafPtr 
} qd; 



white ; 
thePort; 



/* GrafPort Routines */ 

pascal void InitGraf (globalPtr) 

Ptr globalPtr; 
pascal void OpenPort (port) 

GrafPtr port; 
pascal void InitPort (port) 

GrafPtr port; 
pascal void ClosePort (port) 

GrafPtr port; 
pascal void SetPort (port) 

GrafPtr port; 
pascal void GetPort (port) 

GrafPtr *port; 
pascal void GrafDevice (device) 

short device; 
pascal void SetPortBits (bm) 

BitMap *bin; 
pascal void PortSize (width, height) 

short width, height; 
pascal void MovePortTo (leftGlobal, rightGlobal) 

short leftGlobal, rightGlobal; 
pascal void SetOrigin (h, v) 

short h,v; 
pascal void SetClip(rgn) 

RgnHandle rgn ; 
pascal void GetClip(rgn) 

RgnHandle rgn; 
pascal void ClipRect(r) 

Rect *r; 
pascal void BackPat(pat) 

Pattern *pat; 



/* Cursor Routines */ 

pascal void InitCursorO 
pascal void SetCursor (crsr) 

Cursor *crsr; 
pascal void HideCursorO 
pascal void ShowCursor() 
pascal void ObscureCursor () 



/* Line Routines */ 

pascal void HidePenO 
pascal void ShowPen() 
pascal void GetPen(pt) 

Point *pt; 
pascal void GetPenState (pnState) 

PenState *pnState; 
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pascal void SetPenState(pnState) 

PenState *pnState; 
pascal void PenSize (width, height) 

short width, height ; 
pascal void PenMode (mode) 

short mode; 
pascal void PenPat(pat) 

Pattern *pat; 
pascal void PenNormal () 
pascal void MoveTo(h,v) 

short h,v; 
pascal void Move(dh,dv) 

short dh,dv; 
pascal void LineTo(h,v) 

short h,v; 
pascal void Line(dh,dv) 

short dh,dv; 



/* Text Routines */ 

pascal void TextFont (font) 

short font; 
pascal void TextFace(face) 

Style face; 
pascal void TextMode(mode) 

short mode; 
pascal void TextSize (size) 

short size; 
pascal void SpaceExtra (extra) 

long extra; 
pascal void DrawChar(ch) 

short ch; 
void Drawstring (s) 

char *s; 
pascal void DrawText (textBuf ,firstByte,byteCount) 

Ptr textBuf; 

short firstByte,byteCount; 
pascal short CharWidth(ch) 

short ch; 
short StringWidth(s) 

char *s; 
pascal short TextWidth (textBuf, firstByte,byteCount) 

Ptr textBuf; 

short firstByte,byteCount; 
pascal void GetFontlnfo (info) 

Fontlnfo *info; 



/* Drawing in Color */ 

pascal void ForeColor (color) 

long color; 
pascal void BackColor (color) 

long color; 
pascal void ColorBit (whichBit) 

short whichBit; 
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/* Rectangle Calculations */ 

pascal void SetRect (r, left, top, right, bottom) 

Rect *r; 

short left, top, right, bottom; 
pascal void Of fsetRect (r,dh,dv) 

Rect *r; 

short dh,dv; 
"pascal void InsetRect (r,dh,dv) 

Rect *r; 

short dh,dv; 
pascal Boolean SectRect (srcRectl, srcRect2,dstRect) 

Rect *srcRectl, *srcRect2, *dstRect; 
pascal void UnionRect (srcRectl, srcRect2,dstRect) 

Rect *srcRectl, *srcRect2,*dstRect; 
Boolean PtlnRect (pt,r) 

Point *pt; 

Rect *r; 
"void Pt2Rect (ptl,pt2,dstRect) 

Point *ptl, *pt2; 

Rect *dstRect; 
void PtToAngle (r,pt, angle) 

Rect *r; 

Point *pt; 

short *angle; 
pascal Boolean EqualRect (recti, rect2) 

Rect *rectl, *rect2; 
pascal Boolean EmptyRect(r) 

Rect *r; 



/* Graphical Operations on Rectangles */ 

pascal void FrameRect (r) 

Rect *r; 
pascal void PaintRect (r) 

Rect *r; 
pascal void EraseRect (r) 

Rect *r; 
pascal void InvertRect (r) 

Rect *r; 
pascal void FillRect (r,pat) 

Rect *r; 

Pattern *pat; 



/* Oval Routines */ 

pascal void FrameOval(r) 

Rect *r; 
pascal void PaintOval(r) 

Rect *r; 
paacal void EraseOval(r) 

Rect *r; 
pascal void InvertOval (r) 
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Rect *r;- 
pascal void FillOval (r,pat) 
Rect *r; 
Pattern *pat; 



/* RoundRect Routines */ 

pascal void FrameRoundRect (r, ovalWidth, ovalHeight) 

Rect *r; 

short ovalWidth, ovalHeight; 
pascal void PaintRoundRect (r, ovalWidth, ovalHeight) 

Rect *r; 

short ovalWidth, ovalHeight; 
pascal void EraseRoundRect (r, ovalWidth, ovalHeight) 

Rect *r; 

short ovalWidth, ovalHeight ; 
pascal void InvertRoundRect (r, ovalWidth, ovalHeight) 

Rect *r; 

short ovalWidth, ovalHeight ; 
pascal void FillRoundRect (r, ovalWidth, ovalHeight, pat) 

Rect *r; 

short ovalWidth, ovalHeight ; 

Pattern *pat; 



/* Arc Routines */ 

pascal void FrameArc (r, startAngle,arcAngle) 

Rect *r; 

short start Angle, arcAngle; 
pascal void PaintArc(r,startAngle,araAngle) 

Rect *r; 

short start Angle, arcAngle; 
pascal void EraseArc(r,startAngle, arcAngle) 

Rect *r; 

short startAngle, arcAngle; 
pascal void Invert Arc (r, startAngle, arcAngle) 

Rect *r; 

short startAngle, arcAngle; 
pascal void FillArc(r, startAngle, arcAngle, pat) 

Rect *r; 

short startAngle, arcAngle; 

Pattern *pat; 



/* Region Calculations *■/' 

pascal RgnHandle NewRgn() 
pascal void DisposeRgn (rgn) 

RgnHandle rgn; 
pascal void CopyRgn (srcRgn,dstRgn) 

RgnHandle srcRgn,dstRgn; 
pascal void SetEmptyRgn(rgn) 

RgnHandle rgn; 
pascal void SetRectRgn( rgn, left, top, right, bottom) 

RgnHandle rgn; 
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short left, top, right, bottom; 
pascal void RectRgn (rgn, r) 

RgnHandle rgn; 

Rect *r; 
pascal void OpenRgn ( ) 
pascal void CloseRgn(dstRgn) 

RgnHandle dstRgn; 
pascal void OffsetRgn(rgn,dh,dv) 

RgnHandle rgn ; 

short dh,dv; 
pascal void InsetRgn (rgn,dh,dv) 

RgnHandle rgn ; 

short dh,dv; 
pascal void SectRgn (srcRgnA, srcRgnB, dstRgn) 

RgnHandle srcRgnA, srcRgnB, dstRgn; 
pascal void UnionRgn (srcRgnA, srcRgnB, dstRgn) 

RgnHandle srcRgnA, srcRgnB, dstRgn; 
pascal void DiffRgn (srcRgnA, srcRgnB, dstRgn) 

RgnHandle srcRgnA, srcRgnB, dstRgn; 
pascal void XorRgn (srcRgnA, srcRgnB, dstRgn) 

RgnHandle srcRgnA, srcRgnB, dstRgn; 
Boolean PtlnRgn (pt, rgn) 

Point *pt; 

RgnHandle rgn ; 
pascal Boolean RectInRgn(r,rgn) 

Rect *r; 

RgnHandle rgn ; 
pascal Boolean EqualRgn(rgnA, rgnB) 

RgnHandle rgnA, rgnB; 
pascal Boolean EmptyRgn (rgn) 

RgnHandle rgn ; 



/* Graphical Operations on Regions */ 

pascal void FrameRgn(rgn) 

RgnHandle rgn ; 
pascal void PaintRgn(rgn) 

RgnHandle rgn; 
pascal void EraseRgn(rgn) 

RgnHandle rgn; 
pascal void Invert Rgn (rgn) 

RgnHandle rgn; 
pascal void FillRgn(rgn,pat) 

RgnHandle rgn; 

Pattern *pat; 



/* Graphical Operations on Bit Maps */ 

pascal void ScrollRect (r,dh,dv,updateRgn) 

Rect *r; 

short dh,dv; 

RgnHandle updateRgn; 
pascal void CopyBits (srcBits,dstBits,srcRect,dstRect,mode,maskRgn) 

BitMap *srcBits,*dstBits; 

Rect *srcRect, *dstRect; 
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short mode; 
RgnHandle maskRgn; 



/* Picture Routines */ 

pascal PicHandle OpenPicture(picFrame) 

Rect *picFrame; 
pascal void PicComment (kind,dataSize,dataHandle) 

short kind, dataSize; 

Handle dataHandle; 
pascal void ClosePicture () 
pascal void DrawPicture (myPicture,dstRect) 

PicHandle myPicture; 

Rect *dstRect; 
pascal void KillPicture (myPicture) 

PicHandle myPicture; 



/* Polygon Calculations */ 

pascal PolyHandle OpenPolyO 
pascal void ClosePolyO 
pascal void KillPoly(poly) 

PolyHandle poly; 
pascal void OffsetPoly (poly, dh,dv) 

PolyHandle poly; 

short dh,dv; 



/* Graphical Operations on Polygons */ 

pascal void FramePoly (poly) 

PolyHandle poly; 
pascal void PaintPoly (poly) 

PolyHandle poly; 
pascal void ErasePoly (poly) 

PolyHandle poly; 
pascal void InvertPoly (poly) 

PolyHandle poly; 
pascal void FillPoly (poly, pat) 

PolyHandle poly; 

Pattern *pat; 



/* Point Calculations */ 

void AddPt(srcPt,dstPt) 

Point *srcPt,*dstPt; 
void SubPt (srcPt,dstPt) 

Point *srcPt,*dstPt; 
pascal void SetPt (pt,h,v) 

Point *pt; 

short h,v; 
Boolean EqualPt (ptl,pt2) 

Point *ptl, *pt2; 
pascal void LocalToGlobal(pt) 
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Point *pt; 
"pascal void GlobalToLocal (pt) 
Point *pt ; 



/* Miscellaneous Utility Routines */ 

pascal short Random () 
pascal Boolean GetPixel (h, v) 

short h,v; 
void StuffHex(thingPtr,s) 
"Ptr thingPtr; 

char *s; 
pascal void ScalePt (pt, srcRect,dstRect) 

Point *pt; 

Rect *srcRect, *dstRect; 
pascal void MapPt (pt, srcRect,dstRect) 

Point *pt; 

Rect *srcRect,*dstRect; 
pascal void MapRect (r,srcRect,dstRect) 

Rect *r, *srcRect, *dstRect; 
pascal void MapRgn (rgn, srcRect,dstRect) 

RgnHandle rgn; 

Rect *srcRect,*dstRect; 
pascal void MapPoly (poly; srcRect,dstRect) 

PolyHandle poly; 

Rect *srcRect,*dstRect; 



/* Bottleneck Interface */ 

pascal void SetStdProcs (procs) 

QDProcsPtr procs; 
void StdText (byteCount , text Addr, numer , denom) 
short byteCount; 
Ptr textAddr; 
Point *numer, *denom; 
void StdLine (newPt) 

Point *newPt; 
pascal void StdRect (verb, r) 
Graf Verb verb; 
Rect *r; 
pascal void StdRRect (verb,r,ovalWidth,ovalHeight) 
Graf Verb verb; 
Rect *r; 

short ovalWidth, ovalHeight; 
pascal void StdOval (verb, r) 
Graf Verb verb; 
Rect *r; 
pascal void StdArc (verb, r, startAngle,arcAngle) 
GrafVerb verb; 
Rect *r; 

short startAngle,arcAngle; 
pascal void StdPoly (verb, poly) 
GrafVerb verb; 
PolyHandle poly; 
pascal void StdRgn (verb, rgn) 
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Graf Verb verb; 
RgnHandle rgn; 
pascal void StdBits (srcBits, srcRect,dstRect, mode, maskRgn) 

BitMap *srcBits; 

Rect *srcRect, MstRect; 

short mode; 

RgnHandle maskRgn; 
pascal void StdComment (kind, dataSize, dataHandle) 

short kind, dataSize; 

Handle dataHandle; 
pascal short StdTxMeas (byteCount, textAddr, numer,denom, info) 

short byteCount; 

Ptr textAddr; 

Point *numer, *denom; 

Fontlnfo *info; 
pascal void StdGetPic (dataPtr, byteCount) 

Ptr dataPtr; 

short byteCount; 
pascal void StdPutPic (dataPtr, byteCount) 

Ptr dataPtr; 

short byteCount; 



USER ROUTINES 

pascal void MyText (byteCount, textAddr, numer,denom) 

short byteCount; 

Ptr textAddr; 

Point numer,denom; 
pascal void MyLine (newPt) 

Point newPt; 
pascal void MyRect (verb,r) 

GrafVerb verb; 

Rect *r; 
pascal void MyRRect (verb,r,ovWd, ovHt) 

GrafVerb verb; 

Rect *r; 

short ovWd, ovHt; 
pascal void MyOval (verb, r) 

GrafVerb verb; 

Rect *r; 
pascal void MyArc (verb,r,startAngle,arcAngle) 

GrafVerb verb; 

Rect *r; 

short startAngle,arcAngle; 
pascal void MyPoly (verb, poly) 

GrafVerb verb; 

PolyHandle poly; 
pascal void MyRgn (verb, rgn) 

GrafVerb verb; 

RgnHandle rgn; 
pascal void MyBits (srcBits,srcRect,dstRect,mode,mas]cRgn) 

BitMap *srcBits; 
Rect *srcRect,*dstRect; 
short mode; 
RgnHandle maskRgn; 
pascal void MyCoiranent (kind, dataSize, dataHandle) 

short kind, dataSize; 
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Handle dataHandle; 
pascal short MyTxMeas (byteCount, textAddr,nunier,denom f info) 

short byteCount ; 

Ptr textAddr; 

Point *numer, *denom; 

Font Info *info; 
pascal void MyGetPic (dataPtr, byteCount) 

Ptr dataPtr; 

short byteCount ; 
pascal void MyPutPic (dataPtr, byteCount) 

Ptr dataPtr; 

short byteCount; 

DESCRIPTION 

QuickDraw is the Macintosh graphics package. 

Warning: User routines My Text and MyLine are not identical to their counterparts 
StdText and StdLine. Point parameters to My Text and MyLine are passed by value; 
the corresponding parameters to StdText and StdLine are passed by reference. 

For more detailed information see the QuickDraw chapter of Inside Macintosh. 
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NAME 

resources — Resource Manager 

SYNOPSIS 

#include <types.h> 
♦include <resources.h> 



/* Resource Attributes */ 



♦define 
♦define 
♦define 
♦define 
♦define 
♦define 



resSysHeap 

resPurgeable 

resLocked 

resProtected 

resP reload 

resChanged 



/* Error Numbers */ 

♦define resNotFound 
♦define resFNotPound 
♦define addResFailed 
♦define rmvResFailed 



64 

32 

16 

8 

4 

2 



(-192) 
(-193) 
(-194) 
(-196) 



/* Resource File Attributes */ 

♦define mapReadOnly 128 
♦define mapCompact 64 
♦define mapChanged 32 



/* set if read into system heap 

/* set if purgeable 

/* set if locked 

/* set if protected 

/* set if to be preloaded 

/* set if written to resource file */ 



*/ 
*/ 
*/ 
*/ 
*/ 



/* resource not found 

/* resource file not found 

/* AddResource failed 

/* RmveResource failed 



/* typedef long ResType; appears in file TYPES */ 



/* Initialization */ 



pascal short InitResources () 
pascal void RsrcZonelnit () 



/* Opening and Closing Resource Files */ 

void CreateResFile(fileName) 

char *fileName; 
short OpenResFile(fileName) 

char *fileName; 
pascal void CloseResFile (refNum) 

short refNum; 



/* Checking for Errors */ 
pascal short ResErrort) 

/* Setting the Current Resource File */ 
pascal short CurResFileO 



*/ 
*/ 
*/ 
*/ 



/* set if file is read-only */ 
/* set to compact file on update */ 
/* set if write map on update */ 
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pascal short HomeResFile (theResource) 

Handle theResource; 
pascal void UseResFile(refNum) 

short refNum; 



/* Getting Resource Types */ 

pascal short Count Types () 

pascal void Get IndType (theType, index) 

ResType *theType; 

short index; 



/* Getting and Displosing of Resources */ 

pascal void SetRes Load (load) 

Boolean load; 
pascal short CountResources (theType) 

ResType theType; 
pascal Handle Get IndResource (theType, index) 

ResType theType; 

short index; 
pascal Handle GetResource (theType, thelD) 

ResType theType; 

short thelD; 
Handle GetNamedResource (theType, name) 

ResType theType; 

char *name; 
pascal void LoadResource (theResource) 

Handle theResource; 
pascal void ReieaseResource (theResource) 

Handle theResource; 
pascal void DetachResource (theResource) 

Handle theResource; 



/* Getting Resource Information */ 

pascal short UniquelD (theType) 

ResType theType; 
void GetResInfo (theResource, thelD, theType, name) 

Handle theResource; 

short *theID; 

ResType *theType; 

char *name; 
pascal short GetResAttrs (theResource) 

Handle theResource; 
pascal long SizeResource (theResource) 

Handle theResource; 



/* Modifing Resources */ 

void SetResInfo (theResource, thelD, name) 
Handle theResource; 
short the ID; 
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char *name; 
pascal void SetResAttrs (theResource, attrs) 

Handle theResource; 

short attrs; 
pascal void ChangedRe source (theResource) 

Handle theResource; 
void AddResource (theData,theType,theID,name) 

Handle theData; 

Res Type theType; 

short the ID; 

char *name; 
pascal void RmveResource (theResource) 

Handle theResource; 
pascal void UpdateResFile (refNum) 

short refNum; 
pascal void WriteResource (theResource) 

Handle theResource; 
pascal void SetResPurge (install) 

Boolean install; 

/* Advanced Routines */ 

pascal short GetResFileAttrs (refNum) 

short refNum; 
pascal void SetResFileAttrs (refNum, attrs) 

short refNum; 

short attrs ; 



DESCRIPTION 

The Resource Manager provides access to Macintosh resource files. 

ResType may be specified as a character literal (e.g., MENU'). 

For more detailed information see the Resource Manager chapter of Inside 
Macintosh. 
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NAME 

retrace — Vertical Retrace Manager 

SYNOPSIS 

♦include <types.h> 
#include <retrace.h> 



/* error codes */ 



tdefine noErr 







tdefine qErr 


(- 


1) 


tdefine vTypErr 


(- 


2) 


typedef struct VBLTask { 




struct QElem 


*qLink; 




short 


qType; 




ProcPtr 


vblAddr; 




short 


vblCount 


/ 


short 


vblPhase 




} VBLTask; 







/* no error */ 

/* task entry isn't in the queue */ 

/* qType field isn't vType */ 



/* next queue entry */ 

/* unique id for validity check */ 

/* address of service routine */ 

/* count field for timeout */ 

/* phase to allow synchronization */ 



OSErr VInstall (vblTaskPtr) 
QElemPtr vblTaskPtr; 

OSErr VRemove (vblTaskPtr) 
QElemPtr vblTaskPtr; 

struct QHdr *GetVBLQHdr ( ) 



DESCRIPTION 

The Vertical Retrace Manager schedules and performs recurrent tasks during 
vertical retrace interrupts. 

For more detailed information see the Vertical Retrace Manager chapter of Inside 
Macintosh. 
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NAME 

sane — SANE Numerics 






SYNOPSIS 

♦include <sane.h> 






/* Decimal Representation Constants */ 




♦define SIGDIGLEN 
♦define DECSTROUTLEN 


20 /* significant decimal digits */ 

80 /* max length for decimal string */ 

/* output */ 




/* Decimal Formatting Styles 


*/ 




♦define FLOATDECIMAL 
♦define FIXEDDECIMAL 



1 




/* Exceptions */ 




} 


♦define INVALID 
♦define UNDERFLOW 
♦define OVERFLOW 
♦define DIVBYZERO 
♦define INEXACT 


1 
2 
4 
8 

16 




/* Ordering Relations */ 






♦define GREATERTHAN 
♦define LESSTHAN 
♦define EQUALTO 
♦define UNORDERED 



1 
2 
3 




/* Inquiry Classes */ 






♦define SNAN 
♦define QNAN 
♦define INFINITE 
♦define ZERONUM 
♦define NORMALNUM 
♦define DENORMALNUM 



1 
2 
3 
4 
5 




/* Rounding Directions */ 






♦define TONEAREST 
♦define UPWARD 
♦define DOWNWARD 
♦define TOWARDZERO 



1 
2 

3 




/* Rounding Precisions */ 






♦define EXTPRECISION 
♦define DBLPRECISION 
♦define FLOATPRECISION 



I 
2 




typedef short exception; 


/* sum of INVALID ... INEXACT */ 
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typedef short relop; 


/* 


relational operator 


*/ 


typedef short numclass; 


/* 


inquiry class 


*/ 


typedef short rounddir; 


/* 


rounding direction 


*/ 


typedef short roundpre; 


/* 


rounding precision 


*/ 


typedef short environment; 








typedef struct decimal { 








char sgn, unused; 


/* 


sign for +, 1 for - 


V 


short exp; 


/* 


decimal exponent 


*/ 


struct {unsigned char length, 


text [SIGDIGLEN] , unused} sig; 






/* 


significant digits 


*/ 


} decimal; 








typedef struct decform { 








char style, unused; 


/* 


FLOATDECIMAL or FIXEDDECIMAL 


■'*/ 


short digits; 








} decform; 








typedef void (*halt vector) () ; 






/* Conversions between Binary and Decimal Records *V 




void num2dec (f ,x,d) 


/* 


d < — x, according to format f 


*/ 


decform *f; 








extended x; 








decimal *d; 








extended dec2num(d) 


/* 


returns d as extended 


*/ 


decimal *d; 








/* Conversions between Dec 


Lmal Records and ASCII Strings */ 




void dec2str (f ,d, s) 


/* 


s < — d, according to format f 


*/ 


decform *f; 








decimal *d; 








char *s; 








void str2dec{s,ix,d, vp) /* 


on input ix is starting index into s, on 


.*/ 


char *s; /* 


output ix is one greater than index of last*/ 


short *ix, *vp; /* 


character of longest numeric substring; 


*/ 


decimal *d; ■/* 


boolean vp = "s begining at given ix is a 


*/ 


/* 


valid 


numeric string or a valid prefix of 


*/ 


7* 


some 


numeric string" 


*/ 


/* Arithmetic, Auxiliary, and Elementary Functions */ 




extended f abs (x) 


/* 


absolute value 


*/ 


extended x; 








extended remainder (x,y, quo) 


/* 


IEEE remainder; quo < — 7 low order 


*/ 


extended x,y; 


/* 


bits of integer quotient x/y, 


*/ 


short *quo; 


/* 


-127 <= quo <= 127 


*/ 


extended sqrt (x) 


/* 


square root 


*/ 


extended x; 
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extended rint (x) 


/* round to integral value 




*/' 


extended x; 








extended scalb(n,x) 


/* binary scale: x * 2 A n; 




*/ 


short n; 








extended x; 








extended logb (x) 


/* binary log: 




*/ 


extended x; 


/* binary exponent of normalized x 


*/ 


extended copysign(x,y) 


./* y with sign of x 




*/ 


extended x,y; 








extended nextf loat (x,y) 


/* next float representation after 


*/ 


extended x,y; 


/* (float) x in direction of 


(float) 


y*/ 


extended next double (x, y) 


/* next double representation after 


*/ 


extended x,y; 


•/* (double) x in direction of 


(double) 


y */ 


extended nextextended(x,y) 


/* next extended representation after x 


*/ 


extended x,y; 


/* in direction of y 




*/ 


extended log2 (x) 


/* base-2 log 




*/ 


extended x; 








exrended log(x) 


/* base-e log 




*/ 


extended x; 








extended logl (x) 


/* log(l + x) 




*/ 


extended x; 








extended exp2 (x) 


/* base-2 exponential 




*/ 


extended x; 








extended exp (x) 


/* base-e exponential 




*/ 


extended x; 








extended expl (x) 


/* exp(x) - 1 




*/ 


extended x; 








extended power (x,y) 


/* general exponential: x A y 




*/ 


extended x,y; 








extended ipower(x, i) 


/* integer exponential: x A i 




*/ 


extended x; 








short i; 








extended compound ( r , n) 


/* compound: (1 + r) A n 




*/ 


extended r,n; 








extended annuity (r f n) 


/* annuity: (1 - (1 + r) A (-n) ) / r 


*/ 


extended r,n; 








extended tan(x) 


/* tangent 




*/ 


extended x; 








extended sin(x) 


/* sine 




*/ 


extended x; 








extended cos(x) 


/* cosine 




*/ 


extended x; 








extended atan (x) 


/* arctangent 




*/ 


extended x; 








extended randomx(x) 


/* returns next random number; 


updates 


x; */ 


extended *x; 


/* x integral, 1 <= x <= 2 A 33 


- 2 


*/ 


/* Inquiry Routines */ 








numclass classf loat (x) 


/* class of (float) x 




*/ 


extended x; 








numclass classdouble (x) 


/* class of (double) x 




*/ 


extended x; 








numclass classcomp(x) 


/* class of (comp) x 




*/ 


extended x; 








numclass classextended(x) 


/* class of x 




*/ 


extended x; 
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long signnum(x) 
extended x; 



/* returns for +, 1 for 



/* Environment Access Routines */ 
/* An exception variable encodes the exceptions 
whose sum is its value */ 



void setexception (e, s) 

exception e; 

long s; 
long testexception (e) 

exception e; 
void sethalt(e r s) 

exception e; 

long s; 
long testhalt (e) 

exception e; 
void setround(r) 

rounddir r; 
rounddir getroundO 
void setprecison (p) 

roundpre p; 
roundpre getprecsion () 
void setenvironment (e) 

environment e; 
void getenvironment (e) 

environment *e; 
void procentry(e) 

environment *e; 
void procexit (e) 

environment e; 
haltvector gethaltvector () 
void sethaltvector (v) 

haltvector v; 



/* clrs e flags if s is 0, sets e flags */ 
/* otherwise; may cause halt */ 



/* returns 1 if any e flag is set, 

/* returns otherwise 

/* disables e halts if s is 0, 

/* enables e halts otherwise 



*/ 

*/ 

■*/ 

*/ 



/* returns 1 if any e halt is enabled, */ 
/* returns otherwise */ 

/* sets rounding direction to r ■ */ 



/* returns rounding direction 
/* sets rounding precision to p 

/* returns rounding precision 
/* sets environment to e 

/* e < — environment 

/* e < — environment ; 

/* environment < — IEEE default 

/* temp < — exceptions; environment <- 

/* signals exceptions in temp 

/* returns halt vector 

/* halt vector < — v 



*/ 




*/ 




*/ 




*/ 




*/ 




*/ 




*/ 




e; * 


/ 


*/ 




*/ 




*/ 





/* Comparision Routine */ 

relop relation (x,y) 
extended x,y; 



/* returns relation such that 
/* "x relation y" is true 



/* NaNs and Special Constants */ 



extended nan(c) 

unsigned char c; 
extended inf ( ) 
extended pi ( ) 



/* returns NaN with code c 

/* infinity 
/* pi 



DESCRIPTION 

These routines together with Apple's C language fully support the Standard Apple 
Numeric Environment (SANE). They comprise a scrupulously conforming 
implementation of extended-precision IEEE Standard 754 floating-point arithmetic. 

The Standard Apple Numeric Environment is documented in the Apple Numerics 
Manual. 



*/ 
*/ 



*/ 
*/ 
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NAME 

scrap — Scrap Manager 

SYNOPSIS 

finclude <types.h> 
Mnclude <scrap.h> 

#define noScrapErr (-100) /* desk scrap isn't initialized */ 
fdefine noTypeErr (-102) /* no data of the requested type */ 

typedef struct ScrapStuff { 

long scrapSize; 

Handle scrapHandle; 

short scrapCount; 

short scrapState; 

StringPtr scrapName; 
} ScrapStuff, *PScrapStuff ; 

/* Getting Desk Scrap Information */ 

pascal PScrapStuff InfoScrapO 

/* Keeping the Desk Scrap on the Disk */ 

pascal long UnloadScrapO 
pascal long LoadScrapO 

/* Reading from the Desk Scrap */ 

pascal long GetScrap(hDest, theType, offset) 
Handle hDest; 
ResType theType; 
long *offset; 

/* Writing to the Desk Scrap */ 

pascal long ZeroScrapO 

pascal long PutScrap (length, theType, source) 

long length; 

ResType theType; 

Ptr source; 

DESCRIPTION 

The Scrap Manager provides a mechanism for cutting and pasting between 
applications and desk accessories. 

For more detailed information see the Scrap Manager chapter of Inside 
Macintosh. 
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NAME 

segload — Segment Loader 

SYNOPSIS 

♦include <types.h> 
#include <segload.h> 



/* Message returned by CountAppFiles */ 



# define 
#define 



appOpen 
appPrint 



/* Open the document (s) */ 

1 /* Print the document (s) */ 



typedef struct AppFile { 



short 
OSType 
short 
Str255 
} AppFile; 



vRefNum; 
fType; 
versNum; 
f Name ; 



/* volume reference number */ 

/.* file type */ 

/* version number */ 

/* file name */ 



pascal void UnloadSeg(routineAddr) 

Ptr routineAddr; 
void CountAppFiles (message, count) 

short *message, *count; 
void GetAppFiles (index, theFile) 

short index; 

AppFile *theFile; 
void ClrAppFiles (index) 

short index; 
void GetAppParms (apName, apRefNum, apParam) 

char *apName; 

short *apRefNum; 

Handle *apParam; 
pascal void ExitToShell () 



DESCRIPTION 

The Segment Loader is the part of the Macintosh Operating System that lets you 
divide your application into several parts and have only some of them in memory at 
a time. When an application starts up, the Segment Loader also provides it with a 
list of files to open or print. 

For more detailed information see the Segment Loader chapter of Inside 
Macintosh. 
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NAME 








serial — Serial Drivers 






SYNOPSIS 








♦include 


<types.h> 






♦include 


<serial.h> 






/* Driver reset information 


*/ 


♦define 


baud300 


380 


/* 300~baud */ 


♦define 


baud600 


189 


/* 600 baud */ 


♦define 


baudl200 


94 


/* 1200 baud */ 


♦define 


baudl8 


62 


/* 1800 baud */ 


♦define 


baud2400 


46 


/* 2400 baud */ 


♦define 


baud3600 


30 


/* 3600 baud */ 


♦define 


baud4800 


22 


/* 4800 baud */ 


♦define 


baud7200 


14 


/* 7200 baud */ 


♦define 


baud9600 


10 


/* 9600 baud */ 


♦define 


baudl9200 


4 


/* 19200 baud */ 


♦define 


baud57 600 





/* 57600 baud */ 


♦define 


stoplO 


16384 


/* 1 stop bit */ 


♦define 


stopl5 (• 


-32768) 


/* 1.5 stop bits */ 


♦define 


stop20 (- 


-16384) 


/* 2 stop bits */ 


♦define 


noParity 





/'*• no parity */ 


♦define 


oddParity 


4096 


/* odd parity */ 


♦define 


evenParity 


12288 


/* even parity */ 


♦define 


data5 





/* 5 data bits */ 


♦define 


data 6 


2048 


/* 6 data bits */ 


♦define 


data7 


1024 


/* 7 data bits */ 


♦define 


data 8 


3072 


/* 8 data bits */ 


/* Masks 


for errors */ 




♦define 


swOverrunErr 


1 


/* set if software overrun error */ 


♦define 


parityErr 


16 


/* set if parity error */ 


♦define 


hwOverrunErr 


32 


/* set if hardware overrun error */ 


♦define 


f ramingErr 


64 


/* set if framing error */ 


/* Masks 


for changes that cause events to be posted */ 


♦define 


ctsEvent 


32 


/* set if CTS change will cause event */ 
/* to be posted */ 


♦define 


breakEvent 


128 


/* set if break status change will */ 
/* cause event to be posted */ 


/* Indication that an 


XOFF character was sent */ 


♦define 


xOffWasSent 


0x80 


/* XOFF character was sent */ 


/* Result codes */ 






! : #define 


noErr 





/* no error */ 
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#define openErr ( -23) 


/* Open of RAM Serial Driver failed */ 


typedef enum { 

sPortA, 

sPortB 
} SPortSel; 


/* modem port */ 
/* printer port */ 


typedef struct SerShk { 

char fXOn; 

char fCTS; 

unsigned char xOn; 

unsigned char xOff; 

char errs; 

char evts; 

char flnX; 

char null; 
} SerShk; 


/* XON/XOFF output flow control flag */ 

/* CTS hardware handshake flag */ 

/* XOn character */ 

/* XOff character */ 

/* errors that cause abort */ 

/* status changes that cause events */ 

/* XOn/XOff input flow control flag */ 

/* not used */ 


typedef struct SerStaRec { 

char cumErrs; 

char xOffSent; 

char rdPend; 

char wrPend; 

char ctsHold; 

char xOffHold; 
} SerStaRec; 


/* cumulative errors */ 

/* XOff sent as input flow control */ 

/* read pending flag *■/ 

/* write pending flag */ 

/* CTS flow control hold flag */ 

/* XOff received as output flow control */ 


/* Opening and Closing the RAM 


Serial Driver */ 


OSErr RAMSDOpen(whichPort) 
SPortSel whichPort ; 

void RAMSDClose (whichPort) 
SPortSel whichPort; _, 




/* Changing Serial Driver Information */ 


OSErr SerReset ( refNum, serConf ig) 

short refNum, serConf ig; 
OSErr SerSetBuf (refNum, serBPtr, serBLen) 

short refNum; 
; Ptr serBPtr; 

short serBLen; 
OSErr SerHShake (refNum, flags ) ; 

short refNum; 

SerShk *flags; 
OSErr SerSetBrk (refNum) 

short refNum; 
OSErr SerClrBrk( refNum) 

short refNum; 


/* Getting Serial Driver Information */ 
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OSErr SerGetBuf (refNum, count) 

short refNum; 

long *count; 
CSErr SerStatus (refNum, serSta) 

short refNum; 

SerStaRec *serSta; 

DESCRIPTION 

The RAM Serial Driver and the ROM Serial Driver are Macintosh device drivers for 
handling asynchronous serial communication between a Macintosh application and 
serial devices. 

For more detailed information see the Serial Drivers chapter of Inside 
Macintosh. 
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NAME 

sound — Sound Driver 




SYNOPSIS 

# include <types.h> 
# include <sound.h> 




/* Mode values for synthesizers */ 


#define swMode (-1) 
♦define ftMode 1 
. #def ine ffMode 


/* square-wave synthesizer */ 
/* four-tone synthesizer */ 
/* free-form synthesizer */ 


/* Free-Form synthesizer */ 




typedef unsigned char FreeWave [30001] ; 


typedef struct FFSynthRec { 

short mode; 

Fixed count; 

FreeWave waveBytes; 
} FFSynthRec, *FFSynthPtr; 


/* always ffMode */ 

/* "sizing" factor */ 

/* waveform description */ 


/* Square-Wave synthesizer */ 




typedef struct Tone { 
short count; 

short amplitude; 
short duration; 
} Tone; 


/* frequency */ 

/* amplitude, 0-255 */ 

/* duration in ticks */ 


typedef Tone Tones [5001]; 




typedef struct SWSynthRec { 

short mode ; 

Tones triplets; 
} SWSynthRec, *SWSynthPtr; 


/* always swMode */ 
/* sounds */ 


/* Four-Tone Synthesizer */ 




typedef unsigned char Wave [256]; 


typedef Wave *WavePtr; 




typedef struct FTSoundRec { 
short duration; 
Fixed soundlRate; 
long soundlPhase; 
Fixed sound2Rate; 
long sound2Phase; 
Fixed sound3Rate; 
long sound3Phase; 
Fixed sound4Rate; 


/* duration in ticks */ 
/* tone 1 cycle rate */ 
/* tone 1 byte offset */ 
/* tone 2 cycle rate */ 
/* tone 2 byte offset */ 
/* tone 3 cycle rate */ 
/* tone 3 byte offset */ 
/* tone 4 cycle rate */ 
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long 


sound4Phase; 


WavePtr 


soundlWave; 


WavePtr 


sound2Wave; 


WavePtr 


sound3Wave; 


WavePtr 


sound4Wave; 



} FTSoundRec, *FTSndRecPtr; 

typedef struct FTSynthRec { 

short mode; 

FTSndRecPtr sndRec; 
} FTSynthRec, *FTSynthPtr; 



/* tone 4 byte offset */ 

/* tone 1 wave form */ 

/* tone 2 wave form */ 

/* tone 3 wave form */ 

/* tone 4 wave form */ 



/* always ftMode */ 
/* tones to play */ 



void Start Sound (synthRec,numBytes,completionRtn) 

Ptr synthRec; 

long numBytes; 

ProcPtr completionRtn; 
void StopSoundO 
Boolean SoundDoneO 
void GetSoundVol (level) 

short *level; 
void SetSoundVol (level) 

short level 



DESCRIPTION 

The Sound Driver is a Macintosh device driver for handling sound and music 
generation in a Macintosh application. 

For more detailed information see the Sound Driver chapter of Inside 
Macintosh. 
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NAME 

strings — string conversions 

SYNOPSIS 

♦include <types.h> 
♦include <strings.h> 

String(O) *c2pstr(s) 

char *s; 
char *p2cstr(s) 

String (0) *s; 

DESCRIPTION 

Clpstr converts .$• from a C string to a Pascal string. Plcstr converts s from a 
Pascal string to a C string. Both conversions are done in place. For convenience, 
c2pstr sad p2cstr return s as their function result Both functions will accept nil 
as their parameter and do nothing. 

Pascal strings begin with a length byte. C strings are terminated by a zero byte. 
The macro String is defined in file types.h. 
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NAME 






textedit— TextEdit 




SYNOPSIS 






♦include <types.h> 




♦include <textedit.h> 




♦define teJustLeft 




♦define teJustCenter 1 




♦define teJustRight (-1) 




typedef cha 


c Chars [32001]; 




typedef Cha. 


rs *CharsPtr, **Chai 


•sHandle; 


typedef struct TERec { 




Rect 


destRect; 


/* destination rectangle */ 


Rect 


viewRect; 


/* view rectangle */ 


Rect 


selRect; 


/* select rectangle */ 


short 


lineHeight; 


/* current font lineheight */ 


short 


font As cent; 


/* current font ascent */ 


Point 


selPoint; 


/* selection point (mouseLoc) */ 


short 


selStart; 


/* selection start */ 


short 


selEnd; 


/* selection end */ 


short 


active; 


/* != if active */ 


ProcPtr 


wordBreak; 


/* word break routine */ 


ProcPtr 


clikLoop; 


/* click loop routine */ 


long 


clickTime; 


/* time of first click */ 


short 


clickLoc; 


/* char, location of click */ 


long 


caretTime; 


/* time for next caret blink */ 


short 


caretState; 


/* on/active booleans */ 


short 


just; 


/* fill style */ 


short 


teLength; 


/* length of text below */ 


Handle 


hText; 


/* handle to actual text */ 


short 


recalBack; 


/* != if recal in background */ 


short 


recalLines; 


/* line being recalulated */ 


short 


clikStuff ; 


/* click stuff (internal) */ 


short 


crOnly; 


/* set to -1 if CR Line breaks only */ 


short 


txFont ; 


/* text Font */ 


Style 


txFace; 


/* text Face */ 


short 


txMode; 


/* text Mode */ 


short 


txSize; 


/* text Size */ 


struct GrafPort *inPort; 


/* GrafPort */ 


ProcPtr 


highHook; 


/* highlighting hook */ 


ProcPtr 


caretHook; 


/* highlighting hook */ 


short 


nLines; 


/* number of lines */ 


short 


lineStarts [16001]; 


/* line starts */ 


} TERec, *TEPtr, **TEHandle; 




/* Initialization and Allocation */ 


pascal void 


TEInitO 




pascal TEHandle TENew(destRect 


, viewRect) 


Rect *destRect, *viewRect; 




pascal void 


TEDispose (h) 




TEHandle 


h; 
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/* Accessing Text */ 

pascal void TESetText (text, length, hTE) 

Ptr text; 

long length; 

TEHandle hTE; 
pascal CharsHandle TEGetText (hTE) 

TEHandle hTE; 

/* Insertion Point and Selection Range */ 

pascal void TEIdle(hTE) 

TEHandle hTE; 
void TEClick(pt, extend, hTE) 

Point *pt; 

Boolean extend; 

TEHandle hTE; 
pascal void TESetSelect (selStart,selEnd,hTE) 

long selStart; 

long selEnd; 

TEHandle hTE; 
pascal void TEActivate (hTE) 

TEHandle hTE; 
pascal void TEDeactivate (hTE) 

TEHandle hTE; 

/* Editing */ 

pascal void TEKey (key, hTE) 

short key; 

TEHandle hTE; 
pascal void TECut (hTE) 

TEHandle hTE; 
pascal void TECopy(hTE) 

TEHandle hTE; 
pascal void TEPaste (hTE) 

TEHandle hTE; 
pascal void TEDelete (hTE) 

TEHandle hTE; 
pascal void TEInsert (text, length, hTE) 

Ptr text; 

long length; 

TEHandle hTE; 

/* Text Display and Scrolling */ 

pascal void TESetJust (just, hTE) 

short just; 

TEHandle hTE; 
pascal void TEUpdate (rUpdate,hTE) 

Rect *rUpdate; 

TEHandle hTE; 
pascal void TextBox(text, length, box, just) 

Ptr text; 

long length; 

Rect *box; 

short just; 
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pascal void TEScroll (dh,dv, ME) 
short dh; 
short dv; 

TEHandle hTE; 

/* Scrap Information */ 

OSErr TEFromScrapO 
OSErr TEToScrapO 
Handle TEScrapHandle () 
long TEGetScrapLen ( ) 
void TESetScrapLen (length) 
long length; 

/* Advanced Routines */ 

void SetWordBreak(wBrkProc,hTE) 

ProcPtr wBrkProc; 

TEHandle hTE; 
void SetClikLoop(clikProc,hTE) 

ProcPtr clikProc; 

TEHandle hTE; 
pascal void TECalText (hTE) 

TEHandle hTE; 



USER ROUTINES 

Pascal Boolean MyWordBreak(text,charPos) 

Ptr text; 

short charPos; 
Pascal Boolean MyClikLoopO 

DESCRIPTION 

The TextEdit package provides basic text formatting and editing 

For more detailed information see the TextEdit chapter of Inside Macintosh. 



NOTE 



The user routines highHook and caretHook are called with register conventions 
and therefore can't be C routines. 
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NAME 

toolutils — Toolbox Utilities 

SYNOPSIS 

♦include <types.h> 
♦include <toolutils .h> 

♦define sysPatListID /* resource ID of standard pattern list */ 

♦define iBeamCursor 1 /* text selection */ 

♦define crossCursor 2 /* drawing graphics *7 

♦define plusCursor 3 /* cell selection */ 

♦define watchCursor 4 /* indicating long delay */ 

typedef struct Int64Bit ( 

long hiLong; 

long loLong; 
} Int64Bit; 

typedef struct Cursor *CursPtr, **CursHandle; 
typedef struct Pattern *PatPtr, **PatHandle; 

/* Fixed-Point Arithmetic */ 

pascal Fixed FixRatio (numer,denom) 

short numer,denom; 
pascal Fixed FixMul(a,b) 

Fixed a,b; 
pascal short FixRound(x) 

Fixed x; 

/* String Manipulation */ 

StringHandle NewString (theString) 

char *theString; 
void SetString(h, theString) 

StringHandle h; 

char *theString; 
pascal StringHandle GetString(stringlD) 

short string ID; 
void GetlndString (theString, strListID, index) 

char *theString; 

short strListID; 

short index; 

/* Byte Manipulation */ 

pascal long Munger <h f of f set,ptrl, lengthl,ptr2, length2) 

Handle h; 

long offset; 

Ptr ptrl; 

long lengthl; 

Ptr ptr2; 

long length2; 
pascal void PackBits (srcPtr,dstPtr,srcBytes) 
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Ptr *srcPtr; 
Ptr *dstPtr; 
short srcBytes; 
pascal void UnpackBits (srcPtr,dstPtr,dstBytes) 
Ptr *srcPtr; 
Ptr MstPtr; 
short dstBytes; 

/* Bit Manipulation */ 

pascal Boolean BitTst (bytePtr,bitNum) 

Ptr bytePtr; 

long bitNum; 
pascal void BitSet (bytePtr, bitNum) 

Ptr bytePtr; 

long bitNum; 
pascal void BitClr (bytePtr, bitNum) 

Ptr bytePtr; 

long bitNum; 

/* Logical Operations */ 

pascal long BitAnd(valuel,value2) 

long valuel, value2; 
pascal long BitOr (valuel,value2) 

long valuel, value2; 
pascal long BitXor{ valuel, value2) 

long valuel, value2; 
pascal long BitNot (value) 

long value; 
pascal long BitShift (value, count) 

long value; 

short count; 

/* Other Operations on Ints */ 

pascal short HiWord(x) 

long x; 
pascal short LoWord(x) 

long x; 
pascal void LongMul(a,b,dest) 

long a,b; 

Int64Bit *dest; 

/* Graphics Utilities */ 

void ScreenRes (scrnHRes,scrnVRes) 

short *scrnHRes; 

short *scrnVRes; 
pascal Handle Get Icon (icon ID) 

short iconID; 
pascal void Plotlcon (theRect,theIcon) 

Rect *theRect ; 

Handle the Icon; 
pascal PatHandle GetPattern(patlD) 

short pat ID; 
void GetlndPattern (thePattem,patListID, index) 
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struct Pattern *thePattem; 

short patListID; 

short index; 
pascal CursHandle GetCursor (cursorlD) 

short cursorlD; 
void ShieldCursor (shieldRect, of f setPt) 

Rect *shieldRect; 

Point *offsetPt; 
pascal struct Picture **GetPicture <picID) 

short pic ID; 

/* Miscellaneous Utilities */ 

long DeltaPoint (ptA,ptB) 

Point *ptA; 

Point *ptB; 
pascal Fixed SlopeFromAngle (angle) 

short angle; 
pascal short AngleFromS lope (slope) 

Fixed slope; 

DESCRIPTION 

The Toolbox Utilities provide fixed-point arithmetic; string, byte, and bit 
manipulation; logical operations; and some graphics utilities. 

Warning: NewString and GetString return handles to Pascal strings. 
SetString takes a C string as its parameter and converts it to a Pascal string before 
storing it in the memory location referred to by the string handle. 

For more detailed information see the ToolBox Utilities chapter of Inside 
Macintosh. 
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NAME 

types — common defines and types 



SYNOPSIS 




#includ.€ 


i <types . h> 


#define 


nil 


♦define 


NULL 


typedef 


enum {false, true} Boolean; 


typedef 


char *Ptr; 


typedef 


Ptr *Handle; 


typedef 


long (*ProcPtr) () ; 


typedef 


ProcPtr *ProcHandle; 


typedef 


long Fixed; 


typedef 


unsigned long ResType; 


typedef 


long OS Type; 


typedef 


short OSErr; 


typedef 


short Style; 


typedef 


struct Point { 


short 


v; 


short 


In- 


} Point ; 




typedef 


struct Rect { 


short 


top; 


short 


left; 


short 


bottom; 


short right; 


} Rect; 





#define String (size) struct {\ 

unsigned char length; unsigned char text [size];} 
typedef String (255) Str255, *StringPtr, **StringHandle; 

DESCRIPTION 

These defines and types are shared by several Macintosh lib raries. 

The define String approximates Pascal strings. It creates a struct, not an array. 
Remember to use & when passing structs as parameters. 
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NAME 

windows — Window Managei 




SYNOPSIS 




♦include <types.h> 




♦include <quickdraw.h> 




♦include <windows.h> 




/* Window Definition Procedure IDs */ 


♦define documentProc 





♦define dBoxProc 


l 


♦define plainDBox 


2 


♦define altDBoxProc 


3 


♦define noGrowDocProc 


4 


♦define rDocProc 


16 


/* Types of Windows */ 




♦define dialogKind 


2 


♦define userKind 


8 


/* FindWindow Result Codes */ 


♦define inDesk 





♦define inMenuBar 


1 


♦define inSysWindow 


2 


♦define inContent 


3 


♦define inDrag 


4 


♦define inGrow 


5 


♦define inGoAway 


6 


/* Axis Constraints for 


DragGrayRgn */ 


♦define noConstraint 


' 


♦define hAxisOnly 


1 


♦define vAxisOnly 


2 


/* Messages to window definition functions */ 


♦define wDraw 





♦define wHit 


1 


♦define wCalcRgns 


2 


♦define wNew 


3 


♦define wDispose 


4 


♦define wGrow 


5 


♦define wDrawGIcon 


6 


/* defProc Hit Test Codes */ 


♦define wNoHit 





♦define wlnContent 


1 


♦define wlnDrag 


2 


♦define wlnGrow 


3 


♦define wlnGoAway 


4 
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#define deskPatID 16 
typedef GrafPtr WindowPtr; 

typedef struct WindowRecord { 

Graf Port port; 

short windowKind; 

Boolean visible; 

Boolean hilited; 

Boolean goAwayFlag; 

Boolean spareFlag; 

RgnHandle strucRgn; 

RgnHandle contRgn; 

RgnHandle updateRgn; 

ProcHandle windowDefP roc- 
Handle dataHandle; 

StringHandle titleHandle; 

short titleWidth; 

struct ControlRecord **controlList; 

struct WindowRecord *nextWindow; 

PicHandle windowPic; 

long re f Con; 

} WindowRecord, *WindowPeek; 

/* Initialization and Allocation */ 

pascal void InitWindows () 
pascal void GetWMgrPort (wPort) 

GrafPtr *wPort; 
WindowPtr NewWindow(wStorage, boundsRect, title, visible, procID, behind, 
goAwayFlag, ref Con) 

Ptr wStorage; 

Rect *boundsRect; 

char *title; 

Boolean visible; 

short procID; 

WindowPtr behind; 

Boolean goAwayFlag; 

long ref Con; 
pascal WindowPtr GetNewWindow(windowID, wStorage, behind) 

short windowID; 

Ptr wStorage; 

WindowPtr behind; 
pascal void CloseWindow (theWindow) 

WindowPtr theWindow; 
pascal void DisposeWindow (theWindow) 

WindowPtr theWindow; 

/* Window Display */ 

void SetWTitle (theWindow, title) 

WindowPtr theWindow; 

char *title; 
void GetWTitle (theWindow, title) 

WindowPtr theWindow; 

char *title; 

Page 154 



Ex Libris • David T Craig • August 2009 Page 0162 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 
WINDOWS Macintosh Interface Libraries WINDOWS 

pascal void SelectWindow (theWindow) 

WindowPtr theWindow; 
pascal void HideWindow (theWindow) 

WindowPtr theWindow; 
pascal void ShowWindow (theWindow) 

WindowPtr theWindow; 
pascal void ShowHide (theWindow, showFlag) 

WindowPtr theWindow; 

Boolean showFlag; 
pascal void HiliteWindow (theWindow, fHiLite) 

WindowPtr theWindow; 

Boolean fHiLite; 
pascal void BringToFront (theWindow) 

WindowPtr theWindow; 
pascal void SendBehind (theWindow, behindWindow) 

WindowPtr theWindow; 

WindowPtr behindWindow; 
pascal WindowPtr FrontWindow() 
pascal void DrawGrowIcon (theWindow) 

WindowPtr theWindow; 

/* Mouse Location */ 

short FindWindow(thePt, theWindow) 

Point *thePt; 

WindowPtr *theWindow; 
Boolean TrackGoAway (theWindow, thePt) 

WindowPtr theWindow; 

Point *thePt; 

/* Window Movement and Sizing */ 

pascal void MoveWindow (theWindow, hGlobal,vGlobal, front) 

WindowPtr theWindow; 

short hGlobal,vGlobal; 

Boolean front; 
void DragWindow (theWindow, startPt/boundsRect) 

WindowPtr theWindow; 

Point *startPt; 

Rect *boundsRect ; 
long GrowWindow (theWindow, startPt, sizeRect) 

WindowPtr theWindow; 

Point *startPt; 

Rect *sizeRect; 
pascal void SizeWindow (theWindow, w,h, f Update) 

WindowPtr theWindow; 

short w,h; 

Boolean f Update; 

/* Update Region Maintenance */ 

pascal void InvalRect (badRect) 

Rect *badRect; 
pascal void InvalRgn (badRgn) 

RgnHandle badRgn; 
pascal void ValidRect (goodRect) 

Rect *goodRect ; 
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pascal void ValidRgn (goodRgn) 

RgnHandle goodRgn; 
pascal void BeginUpdate (theWindow) 

WindowPtr theWindow; 
pascal void EndUpdate (theWindow) 

WindowPtr theWindow; 

/* Miscellaneous Utilities */ 

pascal void SetWRefCon (theWindow, data) 

WindowPtr theWindow; 

long data; 
pascal long GetWRef Con (theWindow) 

WindowPtr theWindow; 
pascal void SetWindowPic (theWindow, pic) 

WindowPtr theWindow; 

PicHandle pic; 
pascal PicHandle GetWindowPic (theWindow) 

WindowPtr theWindow; 
long PinRect (theRect,thePt) 

Rect *theRect; 

Point *thePt; 
long DragGrayRgn (theRgn, startPt, limitRect, slopRect, axis,actionProc) 

RgnHandle theRgn; 

Point *startPt; 

Rect *limitRect; 

Rect *slopRect; 

short axis; 

ProcPtr actionProc; 

/* Low- Level Routines */ 

pascal Boolean CheckUpdate(theEvent) 

struct EventRecord *theEvent; 
pascal void ClipAbove (window) 

WindowPeek window; 
pascal void SaveOld (window) 

WindowPeek window; 
pascal void DrawNew (window, update) 

WindowPeek window; 

Boolean update; 
pascal void PaintOne (window, clobberedRgn) 

WindowPeek window; 

RgnHandle clobberedRgn; 
pascal void PaintBehind(startWindow, clobberedRgn) 

WindowPeek startwindow; 

RgnHandle clobberedRgn; 
pascal void CalcVis (window) 

WindowPeek window; 
pascal void CalcVisBehind( startwindow, clobberedRgn) 

WindowPeek startwindow; 

RgnHandle clobberedRgn; 

USER ROUTINES 

pascal MyAction ( ) 
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pascal long MyWindow(varCode, theWindow, message, param) 
short varCode; 
WindowPtr theWindow; 
short message; 
long param; 

DESCRIPTION 

The Window Manager provides routines for creating and manipulating windows. 

For more detailed information see the Window Manager chapter of Inside 
Macintosh, 
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8. Library Index 

The Library Index contains an index entry for all the defines, types, enumeration literals, global variables, 
and functions defined in the Standard C Library section and the Macintosh Interface Libraries section. These 
sections are organized alphabetically by library header. 

Column 1 contains an alphabetical list of the index entries. 

Column 2 specifies the type of declaration (for example, literal) for the index entry. 

Column 3 contains the library header under which documentation for the index entry can be found in 
Section 6 or 7. If column 3 contains "(C)" following the library header — for example, abs(C) — look in the 
Standard C Library section. Otherwise, look in the Macintosh Interface Libraries section. 
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'identifier 


.XXP.e 


Titbrarv 




baud600 


define serial 


abbrevDate 


literal 


packages 




baud7200 


define serial 


abortErr 


define 


devices 




baud9600 


define serial 


abs 


function 


abs (C) 




bdConv 


define packages 


acos 


function 


trig(C) 




bDevCItoh 


define printing 


activateEvt 


define 


events 




bDevLaser 


define printing 


activeFlag 


define 


events 




bdNamErr 


define files 


activMask 


define 


events 




bDraftLoop 


define printing 


AddDrive 


function 


files 




BeginOpdate 


function windows 


AddPt 


function 


quickdraw 




BitAnd 


function toolutils 


addResFailed 


define 


resources 




BitClir 


function toolutils 


AddRe sMenu 


function 


menus 




BitMap 


type quickdraw 


AddResource 


function 


resources 




BitNot 


function toolutils 


Alert 


function 


dialogs 




BitOr 


function toolutils 


Alert Template 


type 


dialogs 




Bit si 6 


type quickdraw 


Alert THndl 


type 


dialogs 




BitSet 


function toolutils 


AlertTPtr 


type 


dialogs 




BitShift 


function toolutils 


Allocate 


function 


files 




BitTst 


function toolutils 


alphaLock 


define 


events 




BitXor 


function toolutils 


altDBoxProc 


define 


windows 




blackBit 


define quickdraw 


AngleFromSlope 


function 


toolutils 




blackColor 


define quickdraw 


annuity 


function 


sane 




BlockMove 


function memory 


applEvt 


define 


event s 




blueBit 


define quickdraw 


applMask 


define 


event s 




blueColor 


define quickdraw 


app2Evt 


define 


event s 




bold 


define quickdraw 


app2Mask 


define 


events 




Boolean 


type types 


app3Evt 


define 


events 




breakEvent 


define serial 


app3Mask 


define 


events 




BringToFront 


function windows 


app4Evt 


define 


events 




bSpdolLoop 


define printing 


app4Mask 


define 


events 




btnCtrl 


define dialogs 


AppendMenu 


function 


menus 




btnState 


define events 


AppFile 


type 


segload 




BOFSIZ 


define setbuf(C) 


appleMark 


define 


fonts 




Button 


function events 


applFont 


define 


fonts 




c2pstr 


function strings 


ApplicZone 


function 


memory 




cairo 


define fonts 


appOpen 


define 


segload 




calcCRgns 


define controls 


appPrint 


define 


segload 




CalcMenuSize 


function menus 


asln 


function 


trig(C) 




CalcVis 


function windows 


at an 


function 


sane 




CalcVisBehind 


function windows 


at an 


function 


trig(C) 




calioc 


function malloc(C) 


at an 2 


function 


trig(C) 




cancel 


define dialogs 


athens 


define 


fonts 




cantStepErr 


define disks 


atof 


function 


atof (C) 




Caution Alert 


function dialogs 


atoi 


function 


atoi (C) 




ceil 


function floor (C) 


autoKey 


define 


events 




century 


define packages 


autoKeyMask 


define 


events 




ChangedResource function resources 


autoTrack 


define 


controls 




char 


type quickdraw 


BackColor 


function 


quickdraw 




char 


type sound 


Back Pat 


function 


quickdraw 




charCodeMask 


define events 


badBtSlpErr 


define 


disks 




Chars 


type textedit 


badCksmErr 


define 


disks 




CharsHandle 


type textedit 


badDBtSlp 


define 


disks 




CharsPtr 


type textedit 


badDCksum 


define 


disks 




Char Width 


function quickdraw 


badMDBErr 


define 


files 




checkBoxProc 


define controls 


badUnitErr 


define 


devices 




Checkltem 


function menus 


baudl200 


define 


serial 




checkMark 


define fonts 


baudl800 


define 


serial 




CheckUpdate 


function windows 


baudl9200 


define 


serial 




chkCtrl 


define dialogs 


baud24 0O 


define 


serial 




classcomp 


function sane 


baud300 


define 


serial 




classdouble 


function sane 


baud3600 


define 


serial 




classext ended 


function sane 


baud4800 


define 


serial 




classf loat 


function sane 


baud57 600 


define 


serial 




clearerr 


macro ferror(C) 
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ClearMenuBar 


function 


menus 


dataVerErr 


define 


disks 




ClipAbove 


function 


windows 


Date2Secs 


function 


Dsutils 




ClipRect 


function 


quickdraw 


DateForm 


type 


oackages 




clkRdErr 


define 


osutils 


DateTimeRec 


type 


ssutils 




clkWrErr 


define 


osut.ils 


dayLdingZ 


define 


Packages 




close 


function 


close (C) 


DBLPRECISION 


define 


sane 




CloseDeskAcc 


function 


desk 


dBoxProc 


define 


windows 




CloseDialog 


function 


dialogs 


DCtlEntry 


type 


devices 




CloseDriver 


function 


devices 


DCtlHandle 


type 


devices 




ClosePicture 


function 


quickdraw 


DCtlPtr 


type 


devices 




' ClosePoly 


function 


quickdraw 


dec2num 


function 


sane 




ClosePort 


function 


quickdraw 


dec2str 


function 


sane 




CloseResFile 


function 


resources 


decform 


type 


sane 




CloseRgn 


function 


quickdraw 


decimal 


type 


sane 




CloseWindow 


function 


windows 


DECSTROUTLEN 


define 


sane 




ClrAppFiles 


function 


segload 


Delay 


function 


osutils 




cmdKey 


define 


event s 


DeleteMenu 


function 


tienus 




CntrlParam 


type 


devices 


DeltaPoint 


function 


toolutils 




ColorBit 


function 


quickdraw 


DENORMALN0M 


define 


sane 




commandMark 


define 


fonts 


Dequeue 


function 


osutils 




CompactMem 


function 


memory 


deskPatID 


define 


windows 




compound 


function 


sane 


DetachResource 


function . 


resources 




condense 


define 


quickdraw 


dialogKind 


define 


windows 




Control 


function 


devices 


DialogPeek 


type 


dialogs 




controlErr 


define 


devices 


DialogPtr 


type 


dialogs 




ControlHandle 


type 


controls 


DialogRecord 


type 


dialogs 




ControlPtr 


type 


controls 


DialogSelect 


function 


dialogs 




ControlRecord 


type 


controls 


DialogTemplate 


type 


dialogs 




CopyBits 


function 


quickdraw 


DialogTHndl 


type 


dialogs 




CopyRgn 


function 


quickdraw 


DialogTPtr 


type 


dialogs 




copysign 


function 


sane 


diamondMark 


define 


fonts 




cos 


function 


sane 


DIBadMount 


function 


packages 




cos 


function 


trig(C) 


DiffRgn 


function 


quickdraw 




cosh 


function 


cosh(C) 


DIFormat 


function 


packages 




CouldAlert 


function 


dialogs 


DILoad 


function 


packages 




CouldDialog 


function 


dialogs 


dlnstErr 


define 


devices 




CountAppFiles 


function 


segload 


dirFulErr 


define 


files 




CountMItems 


function 


menus 


Disableltem 


function 


nenus 




CountResources 


function 


resources 


DiskEject 


function 


disks 




CountTypes 


function 


resources 


diskEvt 


define 


events 




courier 


define 


fonts 


diskMask 


define 


events 




creat 


function 


creat (C) 


dispCntl 


define 


controls 




Create 


function 


files 


DisposDialog 


function 


dialogs 




CreateResFile 


function 


resources 


DisposeControl 


function 


controls 




crossCursor 


define 


toolutils 


DisposeMenu 


function 


tienus 




ctnlcon 


define 


dialogs 


DisposeRgn 


function 


quickdraw 




ctrlltem 


define 


dialogs 


DisposeWindow 


function 


windows 




ctsEvent 


define 


serial 


DisposHandle 


function 


ttemory 




CurResFile 


function 


resources 


DisposPtr 


function 


memory 




currLeadingZ 


define 


packages 


DIUnLoad 


function 


packages 




currNegSym 


define 


packages 


DIVBYZERO 


define 


sane 




currSymLead 


define 


packages 


DIVerify 


function 


packages 




currTrailingZ 


define 


packages 


DIZero 


function 


packages 




CursHandle 


type 


toolutils 


DlgCopy 


function 


dialogs 




Cursor 


type 


quickdraw 


DlgCut 


function 


dialogs 




Cursor 


type 


toolutils 


DlgDelete 


function 


dialogs 




CursPtr 


type 


toolutils 


DlgPaste 


function 


dialogs 




cyanBit 


define 


quickdraw 


dmy 


define 


packages 




cyanColor 


define 


quickdraw 


documentProc 


define 


windows 




data5 


define 


serial 


DOWNWARD 


define 


sane 




data 6 


define 


serial 


dragCntl 


define 


controls 




data 1 


define 


serial 


DragControl 


function 


controls 




data8 


define 


serial 
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DragWindow 


function 


windows 




EMFILE 


define 


Error Numbers (C) 


DrawChar 


function 


quickdraw 




EmptyHandle 


function 


memory 


drawCntl 


define 


controls 




EmptyRect 


function 


quickdraw 


DrawControls 


function 


controls 




EmptyRgn 


function 


quickdraw 


DrawDialog 


function 


dialogs 




Enable Item 


function 


menus 


DrawGrowIcon 


function 


windows 




EndUpdate 


function 


windows 


DrawMemiBar 


function 


menus 




ENFILE 


define 


Error Numbers (C) 


DrawNew 


function 


windows 




ENODEV 


define 


Error Numbers (C) 


DrawPicture 


function 


quickdraw 




ENOENT 


define 


Error Numbers (C) 


Drawstring 


function 


quickdraw 




ENOMEM 


define 


Error Numbers (C) 


DrawText 


function 


quickdraw 




ENOSPC 


define 


Error Numbers (C) 


dRemoveErr 


define 


devices 




ENOTDIR 


define 


Error Numbers (C) 


driverEvt 


define 


events 




Enqueue 


. function 


osutils 


driverMask 


define 


event s 




environment 


type 


sane 


DriveStatus 


function 


disks 




Environs 


function 


osutils 


DrvQEl 


type 


files 




ENXIO 


define 


Srror Numbers (C) 


DrvQElPtr 


type 


files 




EOF 


define 


stdio(C) 


drvQType 


literal 


osutils 




eofErr 


define 


files 


DrvSts 


type 


disks 




EPERM 


define 


Error Numbers (C) 


dsAddressErr 


define 


error 




EqualPt 


function 


quickdraw 


dsBadLaunch 


define 


error 




EqualRect 


function 


quickdraw 


dsBusErr 


define 


error 




EqualRgn 


function 


quickdraw 


dsChkErr 


define 


error 




EqualString 


function 


osutils 


dsCoreErr 


define 


error 




EQUALTO 


define 


sane 


dsFPErr 


define 


error 




erase 


literal 


quickdraw 


dsFSErr 


define 


error 




EraseArc 


function 


quickdraw 


dsIHInstErr 


define 


error 




EraseOval 


function 


quickdraw 


dsIOCoreErr 


define 


error 




ErasePoly 


function 


quickdraw 


dsIrqErr 


define 


error 




EraseRect 


function 


quickdraw 


dskFulErr 


define 


files 




EraseRgn 


function 


quickdraw 


dsklnit 


define 


packages 




EraseRoundRect function 


quickdraw 


dsLineAErr 


define 


error 




EROFS 


define 


Error Numbers (C) 


dsLineFErr 


define 


error 




ErrorSound 


function 


dialogs 


dsLoadErr 


define 


error 




ESPIPE 


define 


Error Numbers (C) 


dsMemFullErr 


define 


error 




evenParity 


define 


serial 


dsMiscErr 


define 


error 




EventAvail 


function 


events 


dsNoPackErr 


define 


error 




EventRecord 


type 


events 


dsNoPkl 


define 


error 




everyEvent 


define 


events 


dsNoPk2 


define 


error 




EvQEl 


type 


osevents 


dsNoPk3 


define 


error 




evType 


literal 


osutils 


dsNoPk4 


define , 


error 




exception 


type 


sane 


dsNoPk5 


define 


error 




exit 


function 


exit (C) 


dsNoPk6 


define 


error 




_exit 


function 


exit (C) 


dsNoPk7 


define 


error 




ExitToShell 


function 


segload 


dsNotThel 


define 


error 




exp 


function 


exp(C) 


dsOvflowErr 


define 


error 




exp 


function 


sane 


dsPrivErr 


define 


error 




expl 


function 


sane 


dsReinsert 


define 


error 




exp2 


function 


sane 


dsStkNHeap 


define 


error 




expand 


define 


quickdraw 


dsSysErr 


define 


error 




extFSErr 


define 


files 


dsTraceErr 


define 


error 




EXTPRECISION 


define 


sane 


dsZeroDivErr 


define 


error 




fabs 


function 


floor (C) 


dummyType 


literal 


osutils 




fabs 


function 


sane 


dupFNErr 


define 


files 




false 


literal 


types 


EACCESS 


define 


Error Numbers (C) 


fBsyErr 


define 


files 


EBADF 


define 


Error Numbers 


(C) 


fclose 


function 


fclose (C) 


ecvt 


function 


ecvt (C) 




fcvt 


function 


ecvt (C) 


editText 


define 


dialogs 




f Desktop 


define 


files 


EEXIST 


define 


Error Numbers (C) 


fDisk 


define 


files 


EINVAL 


define 


Error Numbers (C) 


fdopen 


function 


fopen (C) 


EIO 


define 


Error Numbers(C) 


feedCut 


literal 


printing 


EISDIR 


define 


Error Numbers 


(C) 


feedFanfold 


literal 


printing 


Eject 


function 


files 




feedMechCut 


literal 


printing 
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feedOther 


literal 


printing 


free 


function malloc(C) 


feof 


macro 


ferror (C) 


FreeAlert 


function dialogs 


ferror 


macro 


ferror (C) 


FreeDialog 


function dialogs 


fflush 


function 


f close (C) 


FreeMem 


function memory 


ffMode 


define 


sound 


FreeWave 


type sound 


FFSynthPtr 


type 


sound 


f reopen 


function fopen (C) 


FFSynthRec 


type 


sound 


frexp 


function frexp (C) 


fgetc 


function 


getc(C) 


FrontWindow 


function windows 


fgets 


function 


gets (C) 


f sAtMark 


define files 


fHasBundle 


define 


files 


f scanf 


function scanf (C) 


FILE 


define 


stdio(C) 


FSClose 


function files 


fileno 


macro 


ferror (C) 


f sCurPerm 


define files 


FileParam 


type 


files 


FSDelete 


function files 


fill 


literal 


quickdraw 


fseek 


function fseek (C) 


FillArc 


function 


quickdraw 


fsFromLEOF 


define files 


FillOvai 


function 


quickdraw 


f sFromMark 


define files 


FillPoly 


function 


quickdraw 


fsFromStart 


define files 


FillRect 


function 


quickdraw 


FSOpen 


function files 


FillRgn 


function 


quickdraw 


fsQType 


literal osutils 


FillRoundRect 


function 


quickdraw 


f sRdPerm 


define files 


FindControl 


function 


controls 


fsRdWrPerm 


define files 


FindWindow 


function 


windows 


FSRead 


function files 


FInfo 


type 


files 


fsRnErr 


define files 


FInitQueua 


function 


files 


FSWrite 


function files 


f Invisible 


define 


files 


fsWrPerm 


define files 


f irstDskErr 


define 


disks 


ftell 


function fseek (C) 


Fixed 


type 


types 


ftMode 


define sound 


FIXEDDECTMAL 


define 


sane 


fTrash 


define files 


f ixedFont 


define 


fonts 


FTSndRecPtr 


type sound 


FixMul 


function 


toolutils 


FTSoundRec 


type sound 


FixRatio 


function 


toolutils 


FTSynthPtr 


type sound 


FixRound 


function 


toolutils 


FTSynthRec 


type s 


ound 


FlashMenuBar 


function 


menus 


fwrite 


function fread (C) 


fLckdErr 


define 


files 


geneva 


define fonts 


FLOATDECIMAL 


define 


sane 


GetAlrtStage 


function dialogs 


FLOATPRECISION 


define 


sane 


GetAppFiles 


function segload 


floor 


function 


floor (C) 


Get Appl Limit 


function memory 


flPoint 


define 


packages 


GetAppParms 


function segload 


FlushEvents 


function 


osevents 


getc 


macro getc(C) 


FlushVol 


function 


files 


getCancel 


define packages 


FMInput 


type 


fonts 


GetCaretTime 


function events 


fmod 


function 


floor (C) 


getchar 


function getc(C) 


FMOutPtr 


type 


fonts 


GetClip 


function quickdraw 


FMOutput 


type 


fonts 


GetCRefCon 


function controls 


fnfErr 


define 


files 


GetCTitle 


function controls 


fnOpnErr 


define 


files 


GetCtlAction 


function controls 


f Fontlnfo 


type 


quickdraw 


GetCtlMax 


function controls 


FontRec 


type 


fonts 


GetCtlMin 


function controls 


fontWid 


define 


fonts 


Get Ct lvalue 


function controls 


fopen 


function 


fopen (C) 


GetCursor 


function toolutils 


ForeColor 


function 


quickdraw 


GetDateTime 


function osutils 


fprintf 


function 


printf (C) 


GetDblTime 


function events 


fputc 


function 


putc(C) 


GetDCtlEntry 


function devices 


fputs 


function 


puts(C) 


GetDItem 


function dialogs 


frame 


literal 


quickdraw 


getDlgID 


define packages 


Frame Arc 


function 


quickdraw 


getDrive 


define packages 


FrameOval 


function 


quickdraw 


GetDrvQHdr 


function files 


FramePoly 


function 


quickdraw 


getE ject 


define packages 


FrameRect 


function 


quickdraw 


getenvironment function sane 


FrameRgn 


function 


quickdraw 


GetEOF. 


function files 


FrameRoundRect 


function 


quickdraw 


GetEvQHdr 


function osevents 


f ramingErr 


define 


serial 


GetFInfo 


function files 


fread 


function 


fread (C) 


GetFNum 


function fonts 
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GetFontlnfo 


function 


quickdraw 


GrafDevice 


function quickdraw 


GetFontName 


function 


fonts 


GrafPort 


type quickdraw 


GetFPos 


function 


files 


GrafPtr 


tyP e quickdraw 


GetFSQHdr 


function 


files 


GrafVerb 


type quickdraw 


gethaltvector 


function 


sane 


GREATERTKAN 


define 


sane 


GetHandleSize 


function 


memory 


greenBit 


define quickdraw 


Getlcon 


function 


toolutils 


greenColor 


define quickdraw 


GetlndPattern 


function 


toolutils 


GrowWir.dow 


function windows 


GetlndResource 


function 


resources 


GZCritical 


function 


nemory 


GetlndString 


function 


toolutils 


GZSaveHnd 


function 


tiemory 


GetlndType 


function 


resources 


haltvector 


type 


sane 


Get Item 


function 


menus 


HandAndHand 


function 


osutils 


Getltemlcon 


function 


menus 


Handle 


type 


types 


GetltemMark 


function 


menus 


HandleZone 


function 


nemory 


GetltemStyle 


function 


menus 


HandToHand 


function 


osutils 


GetlText 


function 


dialogs 


hAxisOnly 


define 


controls 


GetKeys 


function 


events 


hAxisOnly 


define 


windows 


GetMenu 


function 


menus 


helvetica 


define 


fonts 


GetMenuBar 


function 


menus 


HideControl 


function 


controls 


GetMHandle 


function 


menus 


HideCursor 


function 


quickdraw 


GetMouse 


function 


event s 


HidePen 


function 


quickdraw 


GetNamedResourcef unction 


resources 


HideWindow 


function 


windows 


GetNewControl 


function 


controls 


HiliteControl 


function 


controls 


GetNewDialog 


function 


dialogs 


HiliteMenu 


function 


menus 


GetNewMBar 


function 


menus 


HiliteWindow 


function 


windows 


GetNewWindow 


function 


windows 


HiWord 


function 


toolutils 


GetNextEvent 


function 


events 


HLock 


function 


memory 


getNmList 


define 


packages 


HNoPurge 


function 


memory 


getOpen 


define 


packages 


HomeResFile 


function 


resources 


GetOSEvent 


function 


osevents 


HPurge 


function 


memory 


GetPattern 


function 


toolutils 


hrLeadingZ 


define 


packages 


GetPen 


function 


quick draw 


HOnlock 


function 


memory 


GetPenState 


function 


quickdraw 


hwOverrunErr 


define 


serial 


GetPicture 


function 


toolutils 


hypot 


function 


hypot (C) 


GetPixel 


function 


quickdraw 


iBeamCursor 


define 


toolutils 


GetPort 


function 


quickdraw 


iconltem 


define 


dialogs 


getprecsion 


function 


sane 


ilOAbort 


define 


printing' 


GetPtrSize 


function 


memory 


iMemFullErr 


define 


printing 


GetResAttrs 


function 


resources 


inButton 


define 


controls 


GetResFileAttrs function 


resources 


inCheckbox 


define 


controls 


GetResInfo 


function 


resources 


inContent 


define 


windows 


GetResource 


function 


resources 


inDesk 


define 


windows 


getround 


function 


sane 


inDownButton 


define 


controls 


gets 


function 


gets(C) 


inDrag 


define 


windows 


GetScrap 


function 


scrap 


INEXACT 


define 


sane 


getScroll 


define 


packages 


inf 


function 


sane 


GetSoundVol 


function 


sound 


INFINITE 


define 


sane 


GetString 


function 


toolutils 


InfoScrap 


function 


scrap 


GetSysPPtr 


function 


osutils 


inGoAway 


define 


windows 


GetTime 


function 


osutils 


inGrow 


define 


windows 


GetTrapAddress 


function 


osutils 


InitAllPacks 


function 


packages 


GetVBLQHdr 


function 


retrace 


InitApplZone 


function 


memory 


GetVCBQHdr 


function 


files 


initCntl 


define 


controls 


GetVInfo 


function 


files 


InitCursor 


function 


quickdraw 


GetVol 


function 


files 


InitDialogs 


function 


dialogs 


GetVRefNum 


function 


files 


InitFonts 


function 


fonts 


getw 


function 


getc(C) 


InitGraf 


function 


quickdraw 


GetWindowPic 


function 


windows 


initlWMErr 


define 


disks 


GetWMgrPort 


function 


windows 


InitMenus 


function 


menus 


GetWRefCon 


function 


windows 


InitPack 


function 


packages 


GetWTitle 


function 


windows 


InitPort 


function 


quickdraw 


GetZone 


function 


memory 


InitResources function 


resources 


GlobalToLocal 


function 


quickdraw 


InitUtil 
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InitWindows 


function 


windows 


IOGetlntl 


function 


packages 




I.nitZone 


function 


memory 


IUMaglDString 


function 


packages 




inMenuBar 


define 


windows 


IOMagString 


function 


packages 




-1 nPageDown 


define 


controls 


IDMetric 


function 


packages 




inPage'Jp 


define 


controls 


IOSetlntl 


function 


packages 




Insert Menu 


function 


menus 


IUTimePString 


function 


packages 




InsertResMenu 


function 


menus 


IDTimeString 


function 


packages 




InsetRect 


function 


quickdraw 


kanji 


define 


fonts 




InsetRgn 


function 


quick draw 


keyCodeMask 


define 


events 




inSysWindow 


define 


windows 


keyDown 


define 


events 




Int64Bit 


type 


toolutils 


keyDownMask 


define 


events 




inTkumb 


define 


controls 


KeyMap 


type 


events 




IntlOHndl 


type 


packages 


keyUp 


define 


events 




IntlOFtr 


type 


packages 


keyUpMask 


define 


events 




IntlORec 


type 


packages 


KillControls 


function 


controls 




IntllHndl 


type 


packages 


KilllO 


function 


devices 




IntllPtr 


type 


packages 


KillPicture 


function 


quickdraw 




IntllRec 


type 


packages 


KillPoly 


function 


quickdraw 




intUtil 


define 


packages 


lastDskErr 


define 


disks 




inUpButton 


define 


controls 


ldexp 


function 


frexp(C) 




INVALID 


define 


sane 


LESSTHAN 


define 


sane 




InvalRect 


function 


windows 


Line 


function 


quickdraw 




InvalRgn 


function 


windows 


LineTo 


function 


quickdraw 




inverseBit 


define 


quickdraw 


LoadResource 


function 


resources 




invert 


literal 


quickdraw 


LoadScrap 


function 


scrap 




InvertArc 


function 


quickdraw 


LocalToGlobal 


function 


quickdraw 




InvertOval 


function 


quickdraw 


log 


function 


exp(C) 




InvertPoly 


function 


quickdraw 


log 


function 


sane 




InvertRect 


function 


quickdraw 


logl 


function 


sane 




InvertRgn 


function 


quickdraw 


loglO 


function 


exp(C) 




InvertRoundRect 


function 


quickdraw 


log2 


function 


sane 




ioctl 


function 


ioctl (C) 


logb 


function 


sane 




ioErr 


define 


files 


london 


define 


fonts 




IOParam 


type 


files 


long 


type 


types 




ioQIype 


literal 


osutils 


longDate 


literal 


packages 




iPFMaxPgs 


define 


printing 


LongMul 


function 


toolutils 




ipower 


function 


sane 


losAngeles 


define 


fonts 




iPrAbort 


define 


printing 


LoWord 


function 


toolutils 




iPrBitsCtl 


define 


printing 


lPaintBits 


define 


printing 




iPrDevCtl 


define 


printing 


lPrLFSixth 


define 


printing 




iPrDrvrRef 


define 


printing 


lPrLineFeed 


define 


printing 




iPrlOCtl 


define 


printing 


lPrPageEnd 


define 


printing 




iPrPgFract 


define 


printing 


lPrReset 


define 


printing 




iPrSavPFil 


define 


printing 


IScreenBits 


define 


printing 




isalnum 


macro 


ctype(C) 


" lseek 


function 


lseek (C) 




is alpha 


macro 


ctype(C) 


macMa chine 


define 


osutils 




isascci 


macro 


ctype(C) 


macXLMa chine 


define 


osutils 




iscntrl 


macro 


ctype(C) 


magentaBit 


define 


quickdraw 




IsDialogEvent 


function 


dialogs 


magentaColor 


define 


quickdraw 




isdigit 


macro 


ctype(C) 


malloc 


function 


malloc (C) 




isgraph 


macro 


ctype(C) 


mapchanged 


define 


resources 




is lower 


macro 


ctype (C) 


mapCompact 


define 


resources 




isprint 


macro 


ctype(C) 


MapPoly 


function 


quickdraw 




ispunct 


macro 


ctype (C) 


MapPt 


function 


quickdraw 




is space 


macro 


ctype (C) 


mapReadOnly 


define 


resources 




isupper 


macro 


ctype (C) 


MapRect 


function 


quickdraw 




isxdigit 


macro 


ctype (C) 


MapRgn 


function 


quickdraw 




italic 


define 


quickdraw 


MaxApplZone 


function 


memory 




itemDisabie 


define 


dialogs 


MaxMem 


function 


memory 




IUCompString 


function 


packages 


maxSize 


define 


memory 




IODateP String 


function 


packages 


mChooseMsg 


define 


menus 




IUDateString 


function 


packages 


mDownMask 


define 


events 




IUEqualString 


function 


packages 
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mdy 


define 


packages 


networkMask 


define 


events 




memccpy 


function 


memory (C) 


NewControl 


function 


controls 




memchr 


function 


memory (C) 


NewDialog 


function 


dialogs 




memcmp 


function 


memory (C) 


NewHandle 


function 


memory 




memcpy 


function 


memory (C) 


NewMenu 


function 


menus 




MemError 


function 


memory 


NewPtr 


function 


memory 




memFullErr 


define 


memory 


NewRgn 


function 


quickdraw 


- 


memFullErr 


define 


osutils 


NewString 


function 


toolutils 




memLockedErr 


define 


memory 


NewWindow 


function 


windows 




memPurErr 


define 


memory 


newYork 


define 


fonts 




memset 


function 


memory (C) 


nextdouble 


function 


sane 




memWZErr 


define 


memory 


nextextended 


function 


sane 




memWZErr 


define 


osutils 


nextfloat 


function 


sane 




MenuHandle 


type 


menus 


nil 


define 


types 




Menulnfo 


type 


menus 


nilHandleErr 


define 


memory 




MenuKey 


function 


menus 


niiHandleErr 


define 


osutils 




MenuPtr 


type 


menus 


noAdrMkErr 


define 


disks 




MenuSelect 


function 


menus 


nbConstraint 


define 


controls 




minLeadingZ 


define 


packages 


noConstraint 


define 


windows 




mntLdingZ 


define 


packages 


noDriveErr 


define 


disks 




ModalDialog 


function 


dialogs 


noDtaMkErr 


define 


disks 




modf 


function 


frexp(C) 


noErr 


define 


devices 




monaco 


define 


fonts 


noErr 


define 


disks 




MoreMasters 


function 


memory 


noErr 


define 


files 




mouseDown 


define 


events 


noErr 


define 


memory 




mouseup 


define 


events 


noErr 


define 


osutils 




Move 


function 


quickdraw 


noErr 


define 


printing 




MoveControl 


function 


controls 


noErr 


define 


retrace 




MoveHHi 


function 


memory 


noErr 


define 


serial 




MovePortTo 


function 


quickdraw 


noGrowDocProc 


define 


windows 




MoveTo 


function 


quickdraw 


noMacDskErr 


define 


files 




MoveWindow 


function 


windows 


noMark 


define 


menus 




mSizeMsg 


define 


menus 


noNybErr 


define 


disks 




Munger 


function 


toolutils 


noParity 


define 


serial 




mDpMask 


define 


events 


normal 


define 


quickdraw 




MyAction 


function 


controls 


normalBit 


define 


quickdraw 




My Act ion 


function 


windows 


NORMALNUM 


define 


sane 




My Arc 


function 


quickdraw 


noScrapErr 


define 


scrap 




My Bits 


function 


quickdraw 


NoteAlert 


function 


dialogs 




MyClikLoop 


function 


text edit 


notelcon 


define 


dialogs 




MyComment 


function 


quickdraw 


notOpenErr 


define 


devices 




MyControl 


function 


controls 


notPatBic 


define 


quickdraw 




MyDlg 


function 


packages 


notPatCopy 


define 


quickdraw 




MyFileFilter 


function 


packages 


notPatOr 


define 


quickdraw 




MyFilter 


function 


dialogs 


notPatXor 


define 


quickdraw 




MyGetPic 


function 


quickdraw 


notSrcBic 


define 


quickdraw 




MyGrowZone 


function 


memory 


notSrcCopy 


define 


quickdraw 




Myltem 


function 


dialogs 


notSrcOr 


define 


quickdraw 




My Line 


function 


quickdraw 


notSrcXor 


define 


quickdraw 




MyMenu 


function 


menus 


noTypeErr 


define 


scrap 




MyOval 


function 


quickdraw 


nsDrvErr 


define 


disks 




MyPoly 


function 


quickdraw 


nsDrvErr 


define 


files 




MyPutPic 


function 


quickdraw 


nsvErr 


define 


files 




MyRect 


function 


quickdraw 


NOLL 


define 


stdio(C) 




MyRgn 


function 


quickdraw 


NULL 


define 


types 




MyRRect 


function 


quickdraw 


nullEvent 


define 


events 




MySound 


function 


dialogs 


num2dec 


function 


sane 




MyText 


function 


quickdraw 


numclass 


type 


sane 




MyTxMeas 


function 


quickdraw 


NumToString 


function 


packages 




MyWindow 


function 


windows 


C_APPEND 


define 


open(C) 




MyWordBreak 


function 


text edit 


ObscureCursor 


function 


quickdraw 




nan 


function 


sane 


0_CREAT 


define 


open(C) 




networkEvt 


define 


events 

Page 
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0_EXCL 


define 


open (C) 


PBGetVol 


function 


files 


of fLinErr 


define 


disks 


PBKilllO 


function 


devices 


OffsetPoly 


function 


quickdraw 


PBMountVol 


function 


files 


OffsetRect 


function 


quickdraw 


PBOffLine 


function 


files 


Of fsetRgn 


function 


quickdraw 


PBOpen 


function 


files 


ok 


define 


dialogs 


PBOpenRF 


function 


files 


open 


function 


open (C) 


PBRead 


function 


files 


OpenDeskAcc 


function 


desk 


PBRename 


function 


files 


OpenDriver 


function 


devices 


PBRstFLock 


function 


files 


openErr 


define 


devices 


PBSetEOF 


function 


files 


openErr 


define 


serial 


PBSetFInfo 


function 


files 


OpenPicture 


function 


quickdraw 


PBSetFLock 


function 


files 


OpenPoly 


function 


quickdraw 


PBSetFPos 


function 


files 


OpenPort 


function 


quickdraw 


PBSetFVers 


function 


files 


Open Res File 


function 


resources 


PBSetVol 


function 


files 


OpenRF 


function 


files 


PBStatus 


function 


devices 


OpenRgn 


function 


quickdraw 


PBUnmountVol 


function 


files 


optionKey 


define 


event s 


PBWrite 


function 


files 


opWrErr 


define 


files 


PenMode 


function 


quickdraw 


0_RDONLY 


define 


open (C) 


PenNormal 


function 


quickdraw 


0_RDWR 


define 


open (C) 


PenPat 


function 


quickdraw 


OSErr 


type 


types 


PenSize 


function 


quickdraw 


OSEventAvail 


function 


osevents 


PenState 


type 


quickdraw 


OS Type 


type 


types 


permErr 


define 


files 


OJTRUNC 


define 


open (C) 


pi 


function 


sane 


outline 


define 


quickdraw 


PicComment 


function 


quickdraw 


OVERFLOW 


define 


sane 


PicHandle 


type 


quickdraw 


0_WRONLY 


define 


open (C) 


picltem 


define 


dialogs 


p2cstr 


function 


strings 


picLParen 


define 


quickdraw 


PackBits 


function 


toolutiis 


PicPtr 


type 


quickdraw 


paint 


literal 


quickdraw 


picRParen 


define 


quickdraw 


PaintArc 


function 


quickdraw 


Picture 


type 


quickdraw 


PaintBehind 


function 


windows 


PinRect 


function 


windows 


PaintOne 


function 


windows 


plainDBox 


define 


windows 


PaintOval 


function 


quickdraw 


Plotlcon 


function 


toolutiis 


PaintPoly 


function 


quickdraw 


plusCursor 


define 


toolutiis 


PaintRect 


function 


quickdraw 


Point 


type 


types 


PaintRgn 


function 


quickdraw 


Polygon 


type 


quickdraw 


PaintRoundRect 


function 


quickdraw 


PolyHandle 


type 


quickdraw 


paramErr 


define 


disks 


PolyPtr 


type 


quickdraw 


pararaErr 


define 


files 


Portsize 


function 


quickdraw 


ParamText 


function 


dialogs 


posCntl 


define 


controls 


parityErr 


define 


serial 


posErr 


define 


files 


patBic 


define 


quickdraw 


Post Event 


function 


osevents 


patCopy 


define 


quickdraw 


pow 


function 


exp(C) 


PatHandle 


type 


toolutiis 


power 


function 


sane 


patOr 


define 


quickdraw 


PrClose 


function 


printing 


PatPtr 


type 


toolutiis 


PrCloseDoc 


function 


printing 


Pattern 


type 


quickdraw 


PrClosePage 


function 


printing 


Pattern 


type 


toolutiis 


PrCtlCall 


function 


printing 


patXor 


define 


quickdraw 


PrDrvrClose 


function 


printing 


PBAllocate 


function 


files 


PrDrvrDCE 


function 


printing 


PBClose 


function 


files 


PrDrvrOpen 


function 


printing 


PBControl 


function 


devices 


PrDrvrVers 


function 


printing 


PBCreate 


function 


files 


PrError 


function 


printing 


PBDelete 


function 


files 


prlnitErr 


define 


osutils 


PBEject 


function 


files 


PrintDefault 


function 


printing 


PBFlushFile 


function 


files 


print f 


function 


printf (C) 


PBFlushVol 


function 


files 


PrJobDialog 


function 


printing 


PBGetEOF 


function 


files 


PrJobMerge 


function 


printing 


PBGetFInfo 


function 


files 


procentry 


function 


sane 


EBGetFPos 


function 


files 


procexit 


function 


sane 


EBGetVInfo 


function 


files 
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ProcPtr 


type 


types 


redColor 


define quickdraw 


PrOpen 


function 


printing 


Region 


type quickdraw 


PrOpenDoc 


function 


printing 


relation 


function sane 


PrOpenPage 


function 


printing 


ReleaseResource function resources 


propFont 


define 


fonts 


relop 


type sane 


PrPicFile 


function 


printing 


remainder 


function sane 


PrSetError 


function 


printing 


Rename 


function files 


PrStlDialog 


function 


printing 


resChanged 


define resources 


PrValidate 


function 


printing 


resCtrl 


define dialogs 


prWrErr 


define 


osutils 


ResError 


function resources 


PScrapStuff 


type 


scrap 


ResetAlrtStage 


function dialogs 


Pt2Rect 


function 


quickdraw 


resFNotFound 


define resources 


PtlnRect 


function 


quickdraw 


resLocked 


define resources 


PtlnRgn 


function 


quickdraw 


resNotFound 


define resources 


Ptr 


type 


types 


resPreload 


define resources 


PtrAndHand 


function 


osutils 


resProtected 


define resources 


PtrToHand 


function 


osutils 


resPurgeable 


define resources 


PtrToXHand 


function 


osutils 


ResrvMem 


function memory 


PtrZone 


function 


memory 


resSysHeap 


define resources 


PtToAngle 


function 


quickdraw 


Restart 


function osutils 


PurgeMem 


function 


memory 


ResType 


type types 


pushButProc 


define 


controls 


rewind 


function fseek(C) 


putc 


macro 


putc(C) 


rfNumErr 


define files 


putCancel 


define 


packages 


RgnHandle 


type quickdraw 


putchar 


macro 


putc(C) 


RgnPtr 


type quickdraw 


putDlgID 


define 


packages 


rint 


function sane 


putDrive 


define 


packages 


RmveResource 


function resources 


putEject 


define 


packages 


rmvResFailed 


define resources 


putName 


define 


packages 


rounddir 


type sane 


puts 


function 


puts (C) 


roundpre 


type sane 


put Save 


define 


packages 


RsrcZonelnit 


function resources 


PutScrap 


function 


scrap 


RstFLock 


function files 


putw 


function 


putc(C) 


sanFran 


define 


fonts 


QBProcs 


type 


quickdraw 


SaveOld 


function windows 


QDProcsPtr 


type 


quickdraw 


scalb 


function 


sane 


QElem 


type 


osutils 


ScalePt 


function quickdraw 


QElemPtr 


type 


osutils 


scanBT 


literal. printing 


qErr 


define 


osutils 


scanf 


function 


scanf (C) 


qErr 


define 


retrace 


scanLR 


literal printing 


QHdr 


type 


osutils 


scanRL 


literal printing 


QHdrPtr 


type 


osutils 


scanTB 


literal printing 


QNAN 


define 


sane 


ScrapStuff 


type 


scrap 


QTypes 


type 


osutils 


ScreenRes 


function 


ioolutils 


radCtrl 


define 


dialogs 


scrollBarProc 


define 


controls 


radioButProc 


define 


controls 


ScrollRect 


function 


quickdraw 


RAMSDClose 


function 


serial 


secLeadingZ 


define 


oackages 


RAMSDOpen 


function 


serial 


Secs2Date 


function 


Dsutils 


rand 


function 


rand(C) 


sectNFF.rr 


define 


disks 


Random 


function 


quickdraw 


SectRect 


function 


quickdraw 


randomx 


function 


sane 


SectRgn 


function 


quickdraw 


rDocProc 


define 


windows 


seekErr 


define "disks 


rdVerify 


define 


files 


SelectWindow 


function 


windows 


read 


function 


read(C) 


SellText 


function 


dialogs 


ReadDateTime 


function 


osutils 


SendBehind 


function 


windows 


" readErr 


define 


devices 


SerClrBrk 


function 


serial 


RealFont 


function 


fonts 


SerGetBuf 


function 


serial 


realloc 


function 


malloc(C) 


SerHShake 


function 


serial 


ReallocHandle 


function 


memory 


SerReset 


function 


serial 


RecoverHandle 


function 


memory 


SerSetBrk 


function 


serial 


Rect 


type 


types 


SerSetBuf 


function 


serial 


RectlnRgn 


function 


quickdraw 


SerShk 


type 


serial 


RectRgn 


function 


quickdraw 


SerStaRec 


type 


serial 


redBit 


define 


quickdraw 
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SetApplBase 


function 


memory 


SFPGetFile 


function packages 


SetApplLimit 


function 


memory 


SFPPutFile 


function packages 


setbuf 


function 


setbuf (C) 


SFPutFile 


function packages 


SetClikLoop 


function 


textedit 


SFReply 


type packages 


SetClip 


function 


quickdraw 


SFTypeList 


type packages 


SetCRefCon 


function 


controls 


shadow 


define quickdraw 


SetCTitle 


function 


controls 


ShieldCursor 


function t 


oolutils 


SetCtlAction 


function 


controls 


shiftKey 


define events 


SetCtlMax 


function 


controls 


shortDate 


literal packages 


SetCtlMin 


function 


controls, 


ShowControl 


function controls 


SetCtlValue 


function 


controls 


ShowCursor 


function quickdraw 


SetCursor 


function 


quickdraw 


ShowHide 


function windows 


SetDAFont 


function 


dialogs 


ShowPen 


function quickdraw 


SetB ate Time 


function 


osutils 


ShowWindow 


function windows 


SetDItem 


function 


dialogs 


SIGDIGLEN 


define sane 


SetEmptyRgn 


function 


quickdraw 


signnum 


function sane 


setenvironment 


function 


sane 


sin 


function sane 


SetEOF 


function 


files 


sin 


function t 


rig(C) 


SetEventMask 


function 


osevents 


sinh 


function sinh(C) 


setexception 


function 


sane 


Size 


type memory 


SetFInfo 


function 


files 


SizeControl 


function controls 


SetFLock 


function 


files 


SizeResource 


function resources 


SetFontLock 


function 


fonts 


SizeWindow 


function windows 


SetFPos 


function 


files 


SlopeFromAngle function toolutils 


SetGrowZone 


function 


memory 


SNAN 


define sane 


sethalt 


function 


sane 


SoundDone 


function sound 


sethaltvector 


function 


sane 


SpaceExtra 


function quickdraw 


SetHandleSize 


function 


memory 


spdAdjErr 


define disks 


Setltem 


function 


menus 


sPortA 


literal serial 


Setltemlcon 


function 


menus 


sPortB 


literal serial 


SetltemMark 


function 


menus 


SPortSel 


type serial 


SetltemStyle 


function 


menus 


sPrDrvr 


define printing 


Set I Text 


function 


dialogs 


sprint f 


function printf (C) 


SetMenuBar 


function 


menus 


sqrt 


function exp(C) * 


setMenuFiash 


function 


menus 


sqrt 


function sane 


SetOrigln 


function 


quickdraw 


srand 


function rand(C) 


SetPenState 


function 


quickdraw 


srcBic 


define quickdraw 


SetPort 


function 


quickdraw 


srcCopy 


define quickdraw 


SetPortBits 


function 


quickdraw 


srcOr 


define quickdraw 


setprecison 


function 


sane 


srcXor 


define quickdraw 


SetPt 


function 


quickdraw 


sscanf 


function 


scanf (C) 


SetPtrSize 


function 


memory 


St age List 


type dialogs 


SetRect 


function 


quickdraw 


St art Sound 


function 


sound 


SetRectRgn 


function 


quickdraw 


statText 


define 


dialogs 


SetResAttrs 


function 


resources 


Status 


function 


devices 


SetResFileAttr 


s function 


resources 


statusErr 


define 


devices 


SetResInfo 


function 


resources 


StdArc 


function 


quickdraw 


SetResLoad 


function 


resources 


StdBits 


function 


quickdraw 


SetResPurge 


function 


resources 


StdComment 


function 


quickdraw 


setround 


function 


sane 


stderr 


define 


stdio(C) 


SetSoundVol 


function 


sound 


stdFile 


define 


packages 


SetStdProes 


function 


quickdraw 


StdGetPic 


function 


quickdraw 


SetString 


function 


toolutils 


stdin 


define 


stdio (C) 


SetTagBuffer 


function 


disks 


StdLine 


function 


quickdraw 


SetTime 


function 


osutils 


stdout 


define 


stdio (C) 


SetTr apAddres s 


function 


osutils 


StdOval 


function 


quickdraw 


SetVol 


function 


files 


StdPoly 


function 


quickdraw 


SetWindowPie 


function 


windows 


StdPutEic 


function 


quickdraw 


SetWordBreak 


function 


textedit 


StdRect 


function 


quickdraw 


SetWRefCon 


function 


windows 


StdRgn 


function 


quickdraw 


SetWTitle 


function 


windows 


StdRRect 


function 


quickdraw 


SetZone 


function 


memory 


StdText 


function 


quickdraw 


SPGetPile 


function 


packages 


StdTxMeas 
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StillDown 


function 


event s 


teJustCenter 


define 


textedit 


stoplO 


define 


serial 


teJustLeft 


define 


textedit 


stoplS 


define 


serial 


teJustRight 


define 


textedit 


stop20 


define 


serial 


TEKey 


function 


textedit 


StopAlert 


function 


dialogs 


TENew 


function 


textedit 


stoplcon 


define 


dialogs 


TEPaste 


function 


textedit 


StopSound 


function 


sound 


TEPtr 


type 


textedit 


Str255 


type 


types 


TERec 


type 


textedit 


str2dec 


function 


sane 


TEScrapHandle 


function 


textedit 


strcat 


function 


string (C) 


TEScroll 


function 


textedit 


strchr 


function 


string (C) 


TESetJust 


function 


textedit 


strcmp 


function 


string (C) 


TESetScrapLen 


function 


textedit 


strcpy 


function 


string (C) 


TESetSelect 


function 


textedit 


String 


define 


types 


TESetText 


function 


textedit 


StringHandle 


type 


types 


testentl 


define 


controls 


StringPtr 


type 


types 


TestControl 


function 


controls 


StringToNum 


function 


packages 


testexcept ion 


function 


sane 


StringWidth 


function 


quickdraw 


testlialt 


function 


sane 


strlen 


function 


string (C) 


TEToScrap 


function 


textedit 


strncat 


function 


string (C) 


TEUpdate 


function 


textedit 


strncmp 


function 


string (C) 


TextBox 


function 


textedit 


strncpy 


function 


string (C) 


TextFace 


function 


quickdraw 


strrchr 


function 


string (C) 


TextFont 


function 


quickdraw 


StuffHex 


function 


quickdraw 


textMenuProc 


define 


menus 


Style 


type 


types 


TextMode 


function 


quickdraw 


SubPt 


function 


quickdraw 


TextSize 


function 


quickdraw , 


SwapFont 


function 


fonts 


TextWidth 


function 


quickdraw 


swMode 


define 


sound 


TFeed 


type 


printing 


swOverrunErr 


define 


serial 


THPrint 


type 


printing 


SWSynthPtr 


type 


sound 


thumbCntl 


define 


controls 


SWSynthRec 


type 


sound 


THz 


type 


memory 


symbol 


define 


fonts 


TickCount 


function 


events 


SysBeep 


function 


osutils 


times 


define 


fonts 


SysError 


function 


error 


tkOBadErr 


define 


disks 


SysParmType 


type 


osutils 


tmfoErr 


define 


files 


sysPatListID 


define 


toolutils 


toascii 


function 


conv(G) 


SysPPtr 


type 


osutils 


tolower 


function 


conv(C) 


SystemClick 


function 


desk 


_tolower 


macro 


conv(C) 


SystemEdit 


function 


desk 


. Tone 


type 


sound 


SystemEvent 


function 


desk 


TONEAREST 


define 


sane 


systemFont 


define 


fonts 


Tones 


type 


sound 


SystemMenu 


function 


desk 


TopMem 


function 


memory 


SystemTask 


function 


desk 


toronto 


define 


fonts 


SystemZone 


function 


memory 


toupper 


function 


conv(C) 


taliesin 


define 


fonts 


_toupper 


macro 


conv(C) 


tan 


function 


sane 


TOWARDZERO 


define 


sane 


tan 


function 


trig(C) 


TPPrint 


type 


printing 


tanh 


function 


tanh(C) 


TPPrPort 


type 


printing 


TEActivate 


function 


textedit 


TPRect 


type 


printing 


TECalText 


function 


textedit 


TPrlnfo 


type 


printing 


TEClick 


function 


textedit 


TPrint 


type 


printing 


TECopy 


function 


textedit 


TPrJob 


type 


printing 


TECut 


function 


textedit 


TPrPort 


type 


printing 


TEDeactivate 


function 


textedit 


TPrStatus 


type 


printing 


TEDelete 


function 


textedit 


TPrStl 


type 


printing 


TEDispose 


function 


textedit 


TPrXInfo 


type 


printing 


TEFromScrap 


function 


textedit 


TrackControl 


function 


controls 


TEGetScrapLen 


function 


textedit 


TrackGoAway 


function 


windows 


TEGetText 


function 


textedit 


trFunc 


define 


packages 


TEHandle 


type 


textedit 


true 


literal 


types 


TEIdle 


function 


textedit 


TScan 


type 


printing 


TEInit 


function 


textedit 


twoSideErr 


define 


disks 


TEInsert 


function 


textedit 

Page 
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underline 


define 


quickdraw 


vType 


literal 


osutils 


ungetc 


function 


ungetc (C) 


vTypErr 


define 


retrace 


UnionRect 


function 


quickdraw 


WaitMouseUp 


function 


event s 


DnionRgn 


function 


quickdraw 


watchCursor 


define 


toolutils 


OniquelD 


function 


resources 


Wave 


type 


sound 


unitEmptyErr 


define 


devices 


WavePt r 


type 


sound 


unlink 


function 


unlink (C) 


wCalcRgns 


define 


windows 


OnloadScrap 


function 


scrap 


wDispose 


define 


windows 


UnloadSeg 


function 


segload 


wDraw 


define 


windows 


UnmduntVol 


function 


files 


wDrawGIcon 


define 


windows 


UNORDERED 


define 


sane 


wGrow 


define 


windows 


OnpackBits 


function 


toolutils 


wHit 


define 


windows 


updateEvt 


define 


events 


whiteColor 


define 


quickdraw 


updateMask 


define 


events 


wlnContent 


define 


windows 


DpdateResFile 


function 


resources 


WindowPeek 


type 


windows 


DprString 


function 


osutils 


WindowPtr 


type 


windows 


UPWARD 


define 


sane 


WindowRecord 


type 


windows 


useAsync 


define 


osutils 


wlnDrag 


define 


windows 


useATalk 


define 


osutils 


wlnGoAway 


define 


windows 


useFree 


define 


osutils 


wlnGrow 


define 


windows 


OseResFile 


function 


resources 


wNew 


define 


windows 


userltem 


define 


dialogs 


wNoHit 


define 


windows 


userKind 


define 


windows 


wPrErr 


define 


disks 


useWFont 


define 


controls 


wPrErr 


define 


files 


ValidRect 


function 


windows 


write 


function 


write (C) 


ValidRgn 


function 


windows 


WriteParara 


function 


osutils 


vAxisOnly 


define 


controls 


Wr iteRe s ou r ce 


function 


resources 


vAxisOnly 


define 


windows 


writErr 


define 


devices 


VBLTask 


type 


retrace 


wrPermErr 


define 


files 


VCB 


type 


files 


wrOnderrun 


define 


disks 


Venice 


define 


fonts 


xOffWasSent 


define 


serial 


verArabia 


define 


packages 


XorRgn 


function 


quickdraw 


verAustralia 


define 


packages 


yellowBit 


define 


quickdraw 


verBelgiumLux 


define 


packages 


yellowColor 


define 


quickdraw 


ver Britain 


define 


packages 


ymd 


define 


packages 


verCyprus 


define 


packages 


ZERONUM 


define 


sane 


verDenmark 


define 


packages 


ZeroScrap 


function 


scrap 


verFinland 


define 


packages 


Zone 


type 


memory 


verFrance 


define 


packages 








verFrCanada 


define 


packages 








verFrSwiss 


define 


packages 








verGermany 


define 


packages 








verGreece 


define 


packages 








verGrSwiss 


define 


packages 








verlceland 


define 


packages 








verlsrael 


define 


packages 








ver Italy 


define 


packages 








verJapan 


define 


packages 








verMalta 


define 


packages 








verNetherlands 


define 


packages 








verNorway 


define 


packages 








verPortugal 


define 


packages 








verSpain 


define 


packages 








verSweden 


define 


packages 








verTurkey 


define 


packages 








verDS 


define 


packages 








verYugoslavia 


define 


packages 








VInstall 


function 


retrace 








vLckdErr 


define 


files 








volOffLinErr 


define 


files 








volOnLinErr 


define 


files 








VolumeParam 


type 


files 








VRemove 


function 


retrace 

Page 
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**»#»S**««»******»*KS******»**S#**« «**»##*««»* 


■£ & : & & 4 $ & s -& ? 


i ■& •$ ■$• '?: H- ■& :f ■$ & ■$■ $ 'i# $ >; $r "X - $ i% A -$• f£ ■&*#■ * 


***** LISA work: 


SHOP C 


DISK & 


I RECTORY 


**«*» 


*******««*s***s*#s**«««»«** ***#«»- 


*****#****•******» s*s ******** s**ss-x : *s^sssss*# 


LISA WORK 


SHQF 


■ C DIS 


■( I 




Fi lename Si ze 


Ps 


ize 


Last 


-Mod-Data 


Creation-Date Attr 


COW 20 J 21 < 




393 


fi O / T: 4- , 


•R=i~; '; :".^ 


" 09/04/85-11 : 15 


HAC/C/LIB/CRUNTIME .OBJ 1534 




3 


89/04, 


J 'Q ££-.„.. •; |"T- a ^ 


09/84/85-13559 


MftC/C/LJB/CRUNTIH, . , .OBJ 1536 




3. 


09/04, 


'■S5" 1:4! CO 


09/04/85-1 3s 59 


HAC/C/LI B/INTERf ACE . OBJ 2764% 




m 


#8/27, 


'pi%-„ ■six t -;1 


08/27/85-1 6s 18 


MAC/C/L I f /HATH , OBJ 6S56 




13' 


■y / / | <j ^ 


•p2.„ "J .jfc - /7 


07/1 0/85-1 6:45 


HAC/fe/Lli/RUNTIHE.OBJ 1534 




3 


09/04. 


•"p^^, i' iO e ^O 


09/04/85-1 3; 59 


MAC/E/LIB/SANELIB.OBJ £144 




12 


9/ 1 8, 


'85-11? sid 


09/18/85-19:44 


MAC/C/LIB/STDCLIB.OBJ 32256 




63 


«> 9 / n 4 . 


■" o es „. ■?. ,-i .. n - 1 ™! 


09/04/85-14:00 


MAC/C/L I ■B/STDCPRINTF . OBJ 5! 20 




10 


09/04- 


Q-J" J.J-T « 1 I 


r? o / <"' a * o p. „ i & « a Q 


554 . total blocks -for tiles listed 












MAC/C/L 1 B/CRUNTIME . OS J 












MAC/C/LIB/CRUNTIMEARGV.OBJ 












MAC/C/L I 8/ INTERFACE , OBJ 












mC/C/LIB/MATH.OBJ 












MAC/C/L I B/RUNT I ME . OBJ 












MAC/C/LIB/SANEL18 ,08J 












I aiw/ w Liu/ O i 4 J wi-i D » ucu 












MAC/C/LI B/STOCPP1NTF , OBJ 












LISA W0RKSH8F 


C DIS 


K 2 




Fi 1 euame Si z* 


F's 


f 2& 


Lasi- 


■Moo-p&te 


Creation-Date Attr 


MAC/C/INCLUDE/CON, , .TEXT " 4096 




8 


.08/15, 


'85-17:53 


08/15/85-17:53 


MAC/C/ 1 NCLUOE/CTY . . . T EXT 3072 




6. 


84/24, 


"85-l'?;i0 


03/13/85-12:00 


:-lAC/C/INCLUDE/DES . . .TEXT 2848 




4 


05/23/85-10; 34 


05/23/85-10:34 


XAC/C/1NCLUDE/DEV , . .TEXT 3072 




& 


06/15/85-17:53 


08/15/85-17:53 


MAC/C/INCLUDE/QIA . . .TEXT 4696 




8 


08/26, 


'35-11 :56 


08/28/85-11 :55 


MAC/E/INCLUDE/Di S , , .TEXT 3072 




6 


08/15, 


'"pST™ "1 "? = *£0 


uo, .\ -3/ oo .i / : a 4 


MAC/C/ INCLUDE/ERR . . .TEXT 51 20 




10 


06/24, 


"35-17:10 


03/i3/85-12iOC 


MAC/C/INCLUDE/ERR . . .TEXT 2048 




4 


05/23, 


'85-10 ;34 


05/23/85-10:34 


MAC/C/IMCLUDE/EWE . . .TEXT' 3G72 




6 


O-'D/ £ d.' 


85-1 1 34 


05/23/85-10:34 


HAC/C/INCLUDE/fCM. . .TEXT 3072 




6 


04/24/ 


"85-1 7 s 1 i 


03/13/85-12:00 


MAC/C/INCLUDE/FIi... . .TEXT 5120 




10 




"85-17:53 


08/15/85-17:53 


MAC/C/ INCLUDE/PON . , . TEXT 30 72 




6 


05/23, 


'85-10 s34 


05/23/85-10:34 


MAC/C/INCLUDE/IGC. , .TEXT 2048 




4 


06/24/85-17:12 


03/29/85-19:31 


HAC/C/ INCLUDE/MAT . . .TEXT 2048 




4 


07/10, 


'85-11 :16 


03/13/85-12:00 


HAC/C/IHCLUDE/MEM. . .TEXT 2048 




4 


05/23/ 


'85-10:35 


05/23/85-10:35 


MAC/C/ INCLUDE/MEN . . .TEXT 4896 




8 


05/23, 


'85-10:35 


05/23/85-10:35 


MAC/C/ 1NCLUDE/OSE . . . TEXT 20 48 




4 


05/23/ 


'85-10:35 


05/23/85-10:35 


MAC/C/ INCLUDE/OSU. , .TEXT 3072 




& 


68/15, 


"85-17:54 


08/15/85-17:53 


MAC/C/INCLUDE/PAC. . .TEXT 4096 




■3 


05/23/ 


"85-10:35 


05/23/85-10:35 


MAC/C/ INCLUDE/PR I . . .TEXT 5120 




10 


08/15, 


'85-18:00 


08/15/85-18:00 


MA C/f/ INCLUDE/ QUI . . .TEXT 1 4334 




28 


08/09/ 


85-09:52 


08/09/85-09:48 


MAC/C/ INCLUDE/RES . ■ .TEXT 4094 




3 


05/23, 


'85-10:35 


05/23/85-10 :35 


[Data ii/Jun/86j Fi 


1e 


-#12-1 sss 


c d i r e c 1 


"y.TEXTj Psge 1 
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MAC/C/SMCLUPE/RET...TEXT 2048 4 05/23/85-10- 

MAC/C/INC01DE/SAN...TEXT 3072 i 05/23/85-10 : 

MAC/Cy INCLUDE/SCR., '.TEXT 2048 4 03/23/85-10 

MAC/C/1NCLUDE/SEB,.,TEXT 2048 4 05/23/85-1 Qs 

MAC/C/INCLUDE/SER...TEXT . 3072 '6 05/23/85-10 

MAC/C/ INCLUDE/SOU,.. TEXT 3072 6 05/23/85-10: 

MAC/C/INCLUDE/STD. ..TEXT 3072 6 06/24/85-17; 

MAC/C/ INCLUDE/STR . . . TEXT 2048 4 85/23/35-10; 

MAC/C/IMCLUQE/TEX. ..TEXT 40?<S 8 05/23/85-10: 

MAC/G/ INCLUDE/TOO, ..TEXT .4094 .'8 65/23/85-10; 

MAC/C/ INCLUDE/TYP... TEXT 204S 4 05/23/85- i ; 

MAC/C/ INCLUDE VAL . . .TEXT 3072 * 07/1 0/85-1 1 s 

MAC/C/INCLUDE/W1N...TEXT ^144 It 65/23/85-10; 

MAC/C/MAKE.TEXT '7168 14 07/17/85-10? 

MAC/C/SAMFLE/QCSA.. .TEXT 12238 24 02/27/85-18! 

HAD/C/SAMPLE/QDSA...TEXT 2048 4 83/01/85-14: 



35 



OC 



15-10- 



35 

23 
30 
12 



I' 3/ Z-3J O-j- 

05/23/85- 
05/23/85- 



03/ la/as- 

05/23/85- 
05/23/85- 
05/23/85- 
05/23/85- 
03/13/85- 

3/ i-:v Ow 1 
fy3/i Pw^'R^— 

U i—- ' A V.' Uu 

09/01/84- 



■10; 

' 1 U : 

10; 
■10: 
■10: 

■'! 9 ' 
i p , 

■ < fi I 

.F. *J * 
X V = 

-: o . 

A A. i 

10) 

■10; 



! 35 

i00 

, o^: 

:35 
;35 

:00 

: 1 9 

;34 



frJ^ 



234 -total blocks for -file* Listed 

MAC/C/ INCLUDE/CONTROLS ,H .TEXT 
■ MAC/C/ 1 NCLUBJE/CTYPE . H .TEXT 
MAC/C/IMCLUDE/C E3k . H .TEXT 
MAC/:.. INCLUDE/DEVICES.}-!, TEXT 
MAC/C/ INCLUDE/D I AL06S . ri .TEXT 
MAC/C/ INCLUDE/2 1 SKS . h , TEXT 
MAC/C/INCLUDE/EPRHO . H .TEXT 
-MAC/C/ INCLUDE/ERROR . H .TEXT 
mC/C/lNCLUDE/EVENTS . H .TEXT 
- MAC/C/ INCLU6E/FCNTL . H .TEXT 
MAC/C/ 1 IMCLUDE/F I LES . H .TEXT 
MAC/C/ INCLUDE/FONTS . H .TEXT 
MAC/C/1NCLUDE/10CTL .H .TEXT 
MAC/C/INCLUBg/MATH, H.TEXT 
MAC/C/ INCLUDE/MEMORY . H .TEXT 



■'■MAC 



''INCLUDE/MENUS . H .TEXT 



MAC/C/ 1 NCLUDE/05EVENTS .H .TEXT 
MAC/C/ INCLU0E/0SUT 1 LS .H .TEXT 

MAC/C/INCLUDE/PAGKASES M -TEXT 
MAC/C/ INCLUDE/PRINTING . H .TEXT 
MAC/C/INCLUDE/SUlCKDRAW. H.TEXT 

MAC/C/irCLUDE/SEeOURCES . H .TEXT 
MAC/C/ INCLUDE/RETRACE . H .TEXT 
MAC/ C/ INCLUDE/ SAME .H .TEXT 
MAC/C/ 1 NCLU&E/SCRAP . H .TEXT 
MAC/C/ INCLUDE/SE6L0AD . H .TEXT 
MAC/C/INCLUDE/SER1AL .H .TEXT 
MAC/C/ INCLUDE/SOUND , H .TEXT 
HAC/C/INCLU&E/STDI . H.TEXT 
HAC/G/ INCLUDE/ 37 R INGS .H .TEXT 
MAC/C/ INCLUBE/TEXTED IT ,H .TEXT 
MAC/C/ INCLUDE/TQQLUT I LS. H.TEXT 
■■MAC/C/INCLUDE/TYPES. H.TEXT 
! MAC/C/ INCLUDE/UALUES . H .TEXT 
■■MAC/C/1NCLUDE/WIND0WS. H.TEXT 
MAC/C/MAKE.TEXT 
MAC/C/SAHPLE/QOSAMPLE . C .TEXT 



[Dais Ji/Jun/86; File -#12-1 ts-a c di rec Cory. TEXT] 



-'age 
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MAC/C/SAMPLE/QDSAMPLE ■ R .TEXT 



£■3 



i"he End, 



[Date ll/Jun/86; File -#I2~fisa 



■ a r t nr v ,. ! H'X' 
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C-l 


Fi 


Hi -L0yER-MAC/C/lNCLUDE/STD10 = H I!l-Jun-i986J Pag? - i 


< 


1> /* 


\ 


2> stdio.h — Standard G I/O Package 
3> 

4> Copyright Assr learn Tslsphohe 4 Ttiegraph 


< 


f 


5> Used with permission, Apple Computer Inc. (i'?85) 


< 


6} All riqhts reserved. 


< 


7> */ 


i 


8> 




9> #s -fnde-f _STDI0_ 


/ 


!§} #define 3TDI0 


< 


ID 


< 


!2> /* 3<#>stdio.f- ! 2.1 */ 


\ 


!3> 


•V 


I4> ids-fine _NFILE 28 


( 


15) Adeline BUFSIZ 1824 


/ 


16} 


/ 


I?) /* buffer size for muHi -character output to unbuffered tiles */ 


< 


18> idetine _SBFSI2 8 


( 


19> 


< 


28> typed** struct C 


< 


21' > int j:nt| 


/ 


22> unsigned char *„ptri 


< 


23> unsigned char *_bas&; 


i 


24> char-' '_tlag; 


\ 


25> char- file; 


■v 


2&> } FILE; 


( 


2?> 


?* 


28> /* 


i 


2?) * _I0L3F means a file is a terminal j this means, in particular, 


< 


38> * that oatpat will be buffered line by line 


i 


31 > */ 


< 


32) tdstine _IQ'REA0 SSI1 




33> ftdefine ~I0WRT 8882 


( 


34> Sdefine _I0NBF 1884 


{ 


35> Sdefine "lOHYBUF 8818 


< 


36> #detine JOEQF SB28 


< 


3?> ids-fine _I0ERR 8846 


( 


38> #de-Firte JOLBF 8166 




3?> #defirte ~I0RW 82S8 


< 


48> 


< 


41 > Sifnde-f MULL 




42 > *de-Fir,e NULL 8 




43) lend it 




44> ftifridat EOF 




43> idefins EOF <-l) 


/ 


46> lends f 




47> 




48> ^de-fine stdin <&jq&[(H) 


( 


49> ide-fine stdout <&Job[U> 


''■■ 


5i> Sdefine stderr <& iobt21) 




51 > 




52> ids-Fin© JtwfencKp) _bufendtab[<;p>->_f i 1 el 




Lisa Workshop C StdIO Interlace 




Ex Libris • 


David T Craig • August 2009 


Page 0188 of 0212 j 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 



Ftle.5 -L0WE8-MAC/C/iNCLUDE/STD10,H 



Pace 



53 > 
54) 
55) 
56) 
57) 
58 > 
5?> 

m > 

61} 
62} 
63> 
<S4> 
6W> 
6i> 
6?} 
6B> 
69> 
7t> 
7i> 
72) 
73) 
74> 
75) 
76) 



Sde-fins _bulsiz(p) 

#i ■fnde'f I isl 
#defirte getc(p)_ 
idefine putcCXj p) 



Idefine getcharO 

ftdefine putchar(x) 

Mde-Hns c'isarsrrtp 

Mdefine -feoftp) 

ttdefine terror 1 ; p) 

ftde-Fins Tilsr.Oip) 
Mend I -f ' int 



Jsu+emHp) - <p) 



base) 



(— <p)->_cni >= 8 ? < int) *<p>->_ptr+* ; _ti 

(— (p>->_cnt >= 8 ? \ 

(<int) <*(p>->_ptr++ = (unsigned char/ (x>>) 

_l!sbufC (unsigned char) <x), <p>)> 

'getc(stdin5 

potc(<xi, sldoui) 

(CvoisJ) ( , <p)->_f1ag &= 

(Cp)->J!ag & ~I0EOF 

(<p)->_flag fe JOERR) 

Cp)->_f ile 



buf (c) 



i= "(_I0ERR l _10hOF))5 



extern FILE 
extern FILE 
extern long 
extern void 
extern cftar 
extern unsi; 



"_iob[_NFILE5j 

sfop'snO, *fdopen(), *f reopen^ 
ttel ! O : 

rewindO, setfa«4C)f 
*f§e-t3C)j *getsOj 
sned char- *_buf endtabU | 



STDli 
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Fi 


ies -LOyER-HAC/C/INCLODE/FCNTL,H lti-Jm-l?B6} Page - i 


V 


1> /* 


{ 


2> lent' 1 , ,h — open mode Hags 


% 


3> 


( 


4> Copyright American Telephone A'Telsgraph 


{ 


5> Used with permission, Apple Computer Inc.- <i?35) 


< 


6) All rights reserved, 


■C 


7> */ 


< 


8) 


<; 


?> iHntSef FCHTL 


< 


il> Me fins FCHTL 


< 


ii> 


< 


I2> /* 3<8Mcntl,h 2,1 . */ 


< 


I3> /* 3.8 SID # 1.2 */ 


< 


14) /* Flag values accessible to jspsnC.25 and tent] (2) */ 


/ 


15) /* (The first three can only be set by open) */' 


< 


14) ftdefins RDONLY 8 


/ 


17) idefine OJiRONLY i 


< 


IS) Me fins GJtDWR 2 


< 


1?> /* Sideline D_N0ELAY 84 /* Noa-blocking I/O */ 


< 


2S> Adeline APPEND 918. /* append (wr;t== guaranteed at the end) */ 




2i> 


< 


22) /* Flag ualues accessible- only to 'BpenCZ') */ 


i' 


23) ide-fine 0_CREAT 8148? /* open - «i th file create (uses third open s.rg)*/ 


< 


24} Idetsne 0_JRUNC SI S&S /* open with truncation */ 


< 


25) ftdetir.e EXCL S28S8 /* exclusive open */ 


i 


26) 


< 


27) /* ten tlC 2) requests */ 


{ 


23) /* ftdefine FJNJPFD 1 /* Duplicate -f sides */ 


< 


29) /'* Sdefins F_GETFD i /* Set tildes- -f'aQs */ 


< 


38 > /* Ide-fine F_SETFD 2 /* Set -Hides flags */ 


i' 


31) /# ide-fine FJSETFL 3 /» Set file flags */ 


< 


32) /* ide-fine F SETFL 4 /* 'Set -file flags */ 




33) 


< 


34) ft end it FCNTL 




35) 
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C-H- 


F : i 


Is ■, -LQ«Et-HA£/C/iNCLUDE/CTY'P 


E;h 


[II-Jun-1986] Pag? - i 


< 


i> /*_ 






{ 


2) ctype.h" — character 

8) 

4> Copyright American T 


tVpS'5- 






elephone & Telegraph 




t 




, Apple Computer Inc. (1985) 




\ 


6> All rights reserved. 






< 


7> */ 






\ 


&>. 






< 


9> lilndsf , CTYPE 






^ 

/ 


18> #delin# CTYPE 
i i >. 

12) •/* 3<t) ctype.h 






f s 


2.1 */ 




< 


I3> /* 3.0 SID # 


1,2 */ 




< 


14> Maiim JJ SI 






< 


15> ftdellne J- 82 






< 


16) idefine _N M 






it 


i?> Ide-fine _S 8 iff 






i 


ii> Sideline _P «2S 






< 


i?> ftdefins _C 848 






< 


2%> idefine _8 iiil 






^ 


21 > ftde-fine X 8288 






< 


.22) 






^ 


23 > extern char _ctypel 


i » 




{ 


24>_ 






< 


25) Hi-fnde-f lint 






( 


26) idetlns isalpha<c) 


a_cty|>e+l)tc3&(JJi_L)) 




<■ 


27) ftde-fine i supper <c> 


( <_c type* Die l&JJ) 




s 


28> $de*ine is1ower<c) 


<<_€typt+lHc3&_L> 




{ 


29 > M<*i\n$ isdigit(c) 


(C_ctypfr+l)tc1&_N) 




<. 


3B> Sdetine isxdigii(c) 


(<_crype+i)[c3&_X) 




< 


31 > ids-fine isalnum(c) 


<<_ctyp*+iHc3&<JJS_Li_N:s> 




\ 


32> ftde-fine isspacs(c) 


(<_rtype+i)Lc3&j3) 




< 


33> Sdefine ispuncKe) 


<<_ctyp*+lHc]& P> 




{ 


34> ttdefirse isprint(c) 


<(_ctyp«+i)Cc]&(_PI_US._L!_Ni. 


R""i "* 


if 


35> #de-fine isgrsph(c) 


'C_>typ'e*!)[c3&(_f!_jJ._L! _N)i 




< 


36} Sdetirsi* iscntrKc) 


"(C w ctyps4l).Cc]&_C) 




^ 


37) Mde i 1 m i sasc i i ( c ) 


( C unsi grted char ) ( c ) <=8 1 77) 




< 


3i> #define _touppep<c5 


<£c)-Wi¥> 




< 


39> ideline _tolower(c) 


<(c)-'A'*'a') 




< 


48 > #ds4ine toasciK-c) 


C£c)M177) 




% / 


41 > iendif 






{ 


42 } 






< 


43) #' endi-f _CTYPE__ 






\ 


44> 


- 
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CS 


Fi 


lei -LOiSER-mC/iEyiNCLODI/ERRNO.H 


iii-Jun-1986] Page - 1 


( 

< 

< 


1 ) /* 

2> err-no, h — error re* 

0\ 


urn codes 




5' 

4> Copyright American Telephone. & Telegraph . 




\ 


5> "Used with permi'ssipr 


, .Apple. 'Computer Inc. (1985) 




< 


6>_ All rights reserved, 






< 


?> */ 






< 


8>_ 






< 


9> fcifndsf ERRMO 






< 


18> fetefine ERRNQ 






< 


ii>_ 






; 


i2> /* 3<*>errna.h 


2.1 */ 




; 


13> /* 3,8 SID 1 


1.3 »/ 




< 


14) /* 






< 


15> * Error codes 






< 


i«5> */ 






< 


17>. 






f 


18> extern int errno; 






( 


19> 






V 


28> tdsfsne EPERH 1 


/* Not s«f»r--user 


*/ 


< 


21 > #define EMO&CT 2 . 


/# Ho sue ft -file or directory 


*/ 


% 


22> /* tdefine ESRCH "3 


/'* Mo'Siicri process 


*/ 


f 


23> idefine EIHTR 4 


/* interrupted system call 


*/" 


i 


24) ideftrse EIO 5 


/* I/O error 


*/ 


{ 


25) idefine ENXIO 6 


/* Mo- such device or address 


*/ 


{ 


2d> /* Sdefine E2BIG '7 


/•■Apg list too long 


*/ 


\ 


27 > /* ids -fine ENOEXEC 1 


/*,Exec format error 


*/ 


{ 


28> ftdefine EBADF 9 


/s Bad file number 


«/ 


\ 


29} /* idsfine ECHILD 18 


/* Ma children 


*/ 


< 


38 > /"* Sdefirte EAGAIN II 


/* No mars processes 


*/ 


< 


3i> tdefine EMOMEM 12 


■ /*Not tftoagh core 


*/ 


< 


32> idefine EACCES 13 


/* Permi ssi on den i ed 


*/ 


/ 


33) ide-fiRe EFAULT 14 


/* Bad address 


&/ 


% 


34) tote* ins ENOTBLK 15 


/* Block dsvics required 


*/ 


{ 


35) idefine EBUSV U 


/* Meant de«ic«busy 


*/' 


i 


3<S> idefine EE<IST i? 


/* Fi Is sx.ists 


*/ 


< 


3?> idefine EXDEV 18 


/* Cross-device lir^ 


#/ 




38) #de-Firie ENOOEv i? 


/* No such device 


«/" 


( 


39) tdefine ENQTDIR 28 


/'* Not a directory 


*/ 


< 


48) #define EISDIR 21 


/* Is a directory 


'4- ? 


( 


41 > Idefine E1NVAL 22 


/* 3 rival id argument 


■£ * 




42) idefine ENFILE 23 


/* File table overt! a 


$/ 




43> idefine EMFILE 24 


/* Too .many ofse.i fiIs-= 


*/" 


;' 


44) ■ tdef ine ENQTTY 25 


/'* Not a typewr i i*r 


*/ 


<" 


45> idetine ETXTBSY 26 


/* Test file- busy 


#/ 




4<3> #define EFB18 2? 


/* File too large 


*/ 


< 


4?) Idefine ENOSPC 28 


/* No space left on device 


*,'" 


• 


48> idetine ESPIPE 29 


/* Illegal seek 


*/ 


< 


49) #defir<e EROFS 36 


/* Read' only file system 


«/ 


.< 


5i> ttdefine EHLINK 31 


/* Too many 1 inks 


*/" 




51 > /* #defir,e EPIPE "32 


/* Braken pipe 


*/ 




52 > idefine EDOM 33 


/* Hath arg out of domain of 


fum */ 


== 


Li 
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file J -LOUERHiAC/C/I!CLUDE/ERRNELB 



53 > 

54 > 
55> 

56> 
57) 
58> 
5?) 
Sfl> 
6\> 
62> 
63) 
64} 
65> 
66} 



ffaet me 

/ ■& il^ *f 

/ & ^;d§ f 

/'* ide-f 

/* Mai 

/ & i?d§T 

/* #def 

/* #defl 
/* Mb ii 

i endi-f 



e ERAHGE 34 



in? EN0MS6 35 

ine EIDRM 36 

ins ECHRM6 3? 

ine EL2NSYNC 38 

ins EL3HLT 39 

irt-e EL3RST 41 

ine ELNPNG 41 

ms EUNATCH 42 

ins ENGCSI 43 

ins EL2HLT 44 



ERRNO 



/« Hath r-esul t no 

/* No message 
/* Identifier 

/* Channel r-um 
/* Level 2 not 
/* Letfsl 3 ha 1 . 
/« Level 3 res 
/* LirA number 
/* Protocol dr- 
/« No GSI stru 
/* Leye-1 2 h a 1 



ber 
■: 6 d 

St 



>res 
■•si r 

••ed 

:hro 



eritaoii 



range 
,• a i 1 as ! ' : 



*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
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**a*«*^ 


/ 


Ft? 


€'! - 


_0l< 


ER- 


-MAC/C/MAKE £ ! I-Jun-.l98.ii Page 




< 

< 
< 
< 
< 


1> 
'•■ 


* 




C program Compile, Assemble, Link, RMakefy artl HacCor;;, 




3> 

£'■■ 


$ 


/ 


Usage ; <iiiac/c/make (mac/ c/samp 1 e/pr og-r am ) 


> 


1/ 

5> 


* 




T .; e£ iQ dQ ^in-^yn, , sc , k: r (SC8SS s r • :>r ,';,,-„ any =>. S0 * fc-v D&S5 rq 'T' 


-} 


< 


3/ 


s 


c 


tor the appropriate stage desired. For example to fores the program to 




< 


7) 






be recompiled (s.nd thus wifiitj RMaksr- and Mac Coirs < xyun 


} 


t 


8> 


*. 


c 


sffl3.c/c/T!sks i l?Rac/c/san's ! e/or oor am S T) 


} 


t 


9> 


$ 


/ 




} 


< 


!8> 


% 


c 


File nafR-nG conventions^ 


y 


^ 


Ii> 


* 


/ 




} 


{ 


I2> 


x.- 


c 


prograiTi.c .text — C -source 


"V 


< 


!3> 


5 




program. asm. text — ■ assembly language (opt ; oral) 


■J 


< 
< 


14) 


* 


i 


program. r. text — input to resource compiler 




i*> 


* 


-;. 


program-, c «obj — C ofatjtct 




< 


I / / 


* 




program. asm.obj — assembly language object (optional) 


j 


< 


18> 


4. 


i* 


program. obj — 1 inked object 


} 


i 


19) 


$ 


c 


program. rsrc ■■■— M*c 'executable (output of resource compiler) 




< 


23) 


d; 








( 


21 > 


$ 








{ 


22 > 


* 


exec (program^ { program name; (do not include ".c 3 suffix) 3 




i 


23) 
24) 






needCompile, { pass T tc -fore? compile 3 
needAsm, i pass T to -force assemble } 




< 


26) 






nesdLinK; C pass T to force link > 




< 


27} 






CTsxt, C string concatenation temporary ) 




< 


2S> 

3D 






CObj , \ strinc, concatenation temporary > 
AsmText, i string conca'tenatior temDorary > 
hstiOdj , i S- 1 r i ~s g tonc?*-!'^ c ~- " ) 




( 


Of V 






Obj. C striro concatenation tsrioor-arv 3 




< 


32) 






RText, i strinc concatenation temporary } 




< 


CO/ 






Rsrc) C string concatenat ion temporary 5 




/ 


34) 


$ 








< 


35> 


^ 
-* 








< 


3i> 


- 


dS" 


: ault nesdCompile to ■'-•' 




\ 


37) 


^. 


de - 


: aolt needAsro to 'F 




< 


38 > 


3 


de- 


■ay It ns-edLi-rsK to "¥' 




J 


39 > 


* 


c's - 


ault netdRsrc to J ' sr ' 




( 


48) 


$ 








< 


4i> 


$ 


se 


. CTsxt to concat<pro§ram, '.ctsxt') 




■f 


42> 


$ 


SS' 


COfaj to coRcatCprogram, ' .c.obj'") 




< 


43) 


$ 


's- ir 


. AsroTaxt to concs.ti program, '' .asm. text' ) 




4 


44) 


$ 


5£ . f 


AsinObj to cofJC5t(proQraffi 5 ' u asTis = obj * ' ) 




< 


45> 


$ 


5e i 


Obj to concat(program, '.obj' 5 




< 


46) 


3 


se' 


RTsxt to corcat(pro3raEj '.r.tsvit'') 




/ 


47> 


S 


5S ' 


Rsrc to concatCprogras, '.rsrc') 




/ 


48) 


$ 








^ 


49"> 


■i; 








{ 


58) 


* 




Check" \f compile is necessary } 






52> 


"33 


if 


rot (ex i sts(CQfe 1 ) ) then 
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J><2- 


Files -L014ER-MAC/C./MAKE 


Ui-Jun-19861 Pap - 2 


< 53>"$ set needCompite to 'T' 




< 54) * else it newer (CText, CQbj) then 




< S5> % set needCompiie to J T' 




< 56) $ end if 




< 5?) $ 




< 58) * if needCompiie = ~'T then 




< 59) * writeln CText, ' needs compil i no.*' 




< 68) Kunk 




< Si> ? "{ Set options } 




< 62 > { Mo options ) 




< £3} [program], c 




< <54> (listing -file) 




< 65> (object file} 




< 66} % else 




< 67) f " writeln CText, ' does not need compiling,' 




< 68> * end if 




< 69} $ 




< 78> $_ 




i 71 > * C Check if assemble is necessary } 




< 72> $ . 




< 73) $ if existsCAsmText) then 




< 74) $ if not <exists<AsmQbj)5 then 




< 75> * set needAsro to 'V 




< 76} %' else if newer- {ftsnText, AsmObj} then 




< 77> $ set needAsm to 'T' 




< 78> 4 endif 




< ?9> $ ersdif 




< 8S> * 




< 81 > * if needAsm = "T" then 




< 82> * writeln AsmText, ' needs to be assembled,' 




< 83) a£ssemble}[pragram3.4sm 




< 84) {no list file} 1 




< S5> (same output name) 




< 36) * else if existsCAsiiftxt) then 




< 87> * writeln AsmText, ' does not need assembl ir.o = '' 




< 88) * end if 




< 89) * 




< n> t . 




< 9i> % l Check if link is necessary > 




< ?2> $_ 




< 93> * if needCompiie = 'T' then 




< 94) $ set needLink to 'T' 




< 93> i else if needAsm = 'T' then 




< 9<S> $ set needLink to 'T' 




< ??> * el ssif neetfLir* = 'F "then 




< 98> $ if not (existsCObj)) then 




< 99} $ set needLink to 'T' - 




< 188) $ else if newerCCObj, Obj) then 




< i@i> * set needLir.it: to 'T' 




< i82> $ else if exists(AsmObj) then 




< 183> $ if newer CAsmObj, Obj) then 
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"<" 


184} t set needtink to 'T' 


/" 


115) * endif 


■/■ 


1865 * ends! 


\ 


187) $ ends* 


< 


!88> *_ 


< 


189> * if needllnfc = 'T' then- 


/ 


ItS)- f writeln program, '' needs ! inking.' 


V 


Ill) Kui>}1 inker 


< 


U2> ? 


< 


i i 3> *X 


{ 


114) £no more options) 


( 


H5>. [program]. c £■-€ program } 


< 


i 1 6 > * if needAsm = 'T' op exists<AanObj ■ the-. 


< 


li?> £ program] .asm' C Assembly language (optional) > 


{■ 


I i 8> * end if 


< 


t!9> mac/c/1 ib/runtime ' £ Initialization - ; 


£ 


128) * •'. mac/c/1 ih/cr-untims Standard C Library initialization w/cut argv,ara.c ■' 


< 


121 > * £ mac/c/1 ib/crunttmearQi. 1 Standard C Library inti ia! ization w/ argv,argc * 


•', 


122) $ C mac/c/1 ib/sttici ib " Standard C Library '" " - ! 


< 


123) 4- C -mac/c/1 i b/stdcpr in tf Standard C Library print! "i 


< 


124) % i •nac/c/Hb/sanslib - S#4E Numerics -> 


< 


125> mac/c/1 ib/ interface C Inside Macintosh Interface J' 


\ 


126) * : mac/c/i ib/'prl inl High-Levef Printing Interfaces > 


< 


127) 1- C mac/c/1 ib/prscreers Low-Level Printing Inter-faces 3- 


< 


128) i no more object files ) 


< 


129) £nc 1 isting f i le> 


{ 


13S) [program] 


< ? 


131) $_ else 


< 


132) t writeln program, ' does not -need Unking.' 


< 


133) $ end if 


*' 


134) * 


< 


135> * . 


< 


136) * -i Check if RMaRer is necessary J 


< 


137) $. 


% 


1385 * if needLink = 'V thsu 


< 


139) f set needRsrc to 'T' 


S 


148) » esseif needRsrc = 'F' then 


< 


141 > * H : not <exifts(Ssr-c)) then 


< 


142) $ set needRsrc to 'T' 


{ 


143) $ else if newer C Ob j, Rsr-c) then 


< 


144) % set needRsrc to 'V 


( 


145) % else if newer CRText, Rsrc) thers 


{ 


146) * set needRsrc to 'T' 


< 


H?> % endif 


{ 


148> * endif 


f 


149> $ 


< 


158) * if needRsrc - 'T' then 


i 


151 > $ write In program, ' needs Weaker.* 


< 


152) r-CunMac/nisaice'-r 


■f" 


1 53 > _ [program). r 


{ 


154> % else 
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J>^ 



Files -LOWER-MAC/C/HAKE 



?8dJ Paqs - 4 



\ 1S5> % write in program, 
< 156> $• endif 



aoss not ns*d .-0"'&ke! 



-■ 


15?> 


-3- 






< 


158> 


* 






,/ 


15?) 


$ 


Copy the resource t;!s to a. Mac format 


7^ 


< 


168> 


$ 






< 


Ui> 




r lynics.c/^B.cciSiFi 




< 


162) 




F£inderInfo}Y£es}L£i sa->MaeM program] , 


'■$ 


< 


163> 




LprOQf'SJTsi 




\ 


164> 




APPL C T>-p,e 3 




/ 


i£5> 




C Creator [■????] }. 




< 


166> 




N£o) C Set Bundle Bit } 




< 


16?) 




ECj*ct>QCui t) 




< 


i©B : ) 


* 






< 


149) 


-± ~ <- 


iasx^c 




< 


i?l> 









! OU*cr Or ? MS 
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File: -L0WER-MAC/C/SAMPLE/3DSAMPLE . C 



0-1 



[ i 1 — Jun-I '?8«5 1 Fane - \ 



1> 
2> 

3> 
4> 
5> 
&} 
7> 
8> 
.9> 
i§> 
I!> 
12) 
13> 
14) 
15) 
16) 
1?) 
18) 
19) 
28 > 
21 > 
22> 
23) 
24) 
23) 
26> 
27> 
28) 
2?) 
38> 
3!) 
32) 
33> 
34> 
35) 
36) 
3?>_ 
38) 
39 > 
48) 
4$> 
42> 
43> 
44) 
45) 
46) 
4?) 
48) 
49> 
56) 
5i> 
52) 



NAME 



qdsample — fiuickdraw demonstration progr-asr 



SYNOPSIS 

qds ample 

DESCRIPTION 

qdsample displays % matrix of Quickdr-aw objects., including text, 
rectangles, round rectangles, bitmaps, arcs, polygons and ovals. 
and pictures are also demonstrated. 



Recti ons 



AUTHOR 



Written by Bill Atkinson 

C Version by Rick Neyers and Ban Smith 

Copyright 1984 Apple Computer Inc. 



nclude < types.. h> 
nclude <quicKdraw.h> 
nclude <fonts.,h> 



^include <events.h> 

#define HeapSize 14888 

iypetief short iconBsta[?d] ; 

Graf Port myPort; 
iconData iconsf.6]; 
short err-ftes; 
SBProcs procsj 

ins tlccnsO 

/* Manually stuff sobs icons. Normally we would read them from a tile */' 



/* Lisa */ 

St!jttH»x<iicons[8J[ 83 ,"88«ft8t8f 836888888868888888688896808880 1FFFFFFFFC") ; 
SiuffBe <&iconst8]E!2J,'89ft8*e886f^ " . •" ,. 3BFFFFFFFFFA3" ; 

Stuff H8x\&iconstlH243. r! 18iSf«ll8l431iFFFFF§8823126i8838eF23!2«8888BF923 a )', 
StuffHex<4eicons[8][363,*.2s < 8 ol-„ < 23i28888888823i28B8e888F23"> ; 

StuHHex<&iconsC8][48],'12i *~i BF f i FFFFF88823"); 

"StuffHex<&icons[| 68] B 888888 t 38? ; y- -FFFFFE2C) ; 

Stuff Hex<&i consISJ E72] , ' ISMIS §i«3832AAAAA8A9F8d555555i5388C2AAAA82A58i !1 ) ; 
Stuff Hex (&i const 8] [84], "888888 I ?88FFFFFFFFF3 88881 668FFFFFFFFFC88") ; 
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File i -L0UER- l %\ '■'SAMPLE/apSAMPLE.C ■.' Ui-Jun-i98<53 Page 



53> /* Printer */ 

54) StuffHexC&i const IK 83 ^j808f§§M888888880688888g888888088888888088888B8 6 > ; 

3S> Stuff Kex<&i cons! 131 122 , B s?i888§88888eS9887FFFFF88§eB8888e82B86eei 1 1514446" ) 5 



36 > 




< 57> Stu«Hsx(&icor.s[i]I3^] s s §884«8iei3068e'Mft545!8888804088817FE8§F4A5!5ie03 s ); 
<■ 58> Stul-fHsx<&]con5MlC4g3 ! "ei84l«»«!387832?FFFFFlBF864e8es082l80CFFFFFFFC37 ,i )j 

< 5?) Stuff Hex(ii cons! i 2 16%1 , " i388§888886e3888B088eeD??FFFFFFFFFABCS8§8688835.£." > 5 

< <S8> StulfHex(&!ccsn3!l][?23 ) i '88Pilf«SlAC87F8S88i6i58841i8aCCCiB387F9e0CCCi^ ,i > ; 

< 61 > StuffHsx<&iCGnsm[84]/88gee8gg8iCiC8888898838e7FFFFFFFFF8887888881E«e8">; 

< 62> 

< 63> /* Trash Can */ 

i 64} Stuff Hex<&!eons[2H 81 } "£i8®tIFC48838£i58eE8d888888B8388388888880C8?18888"); 

< 65> Stuff Htx<&i eons£2H 121 s *f «lti33498lf e89826C4?80e88e84Ci?3808880886i26e8ee" ) ; 

< <44> StolfHex<&icon5[21C24I, !, iftift44FE89«i83!i?'?8338ga028Ed3Bi88ee82418E8e888")i 

< 6?> Stuff Hex <& i const 23 E 361 . * 'i J33E388 1C8888 1 88E882C8 8888FF88 1 CC6080847FFE8C00 " ) ; 

< 68> 

< 6?> . . ... . _._ ._..._... . 

< 70> StuffH^x^i!CO^£E£3I723 i ,Ir 32SI19£-C82^4«24^24D6!C88524?24CFIJC■4524?24C8? ,, ): 

< 71 > Stuf+he>(i&ir Cr , 5 c2}rS4] / 87842«?2 r K-Hii3S4>'23'3188tr88E888E488ee8CnFFFC3F8 !1 > \ 

< 72> 

< 73> /* Tray */ 

< 74) StuffHexCfc constSH 81, "88818 'v:888..:2338e8aS;:3Sj8,;GB8a8e.8088e888888888 s >' ! 

< 75> 5^*fris-<t> NOISES' '121,' i8§§e88S8i » *' . " 3 if s B88687FFFFFFF8" ) ? 

< 76> Stuff HexC&iconstSi [243 , "ISiEif 8808i8881A8§e88838083688§88e78886A888888D8" ) ; 

< 77) Stuf*H8X'aiCor55i3H36] / , 8l9?FfFFFFB801ftCBi888358'3358888Se-5B8i?FC«8SFFD58 1 ') ; 

< 78) Stuff Hex(&scQn5l33I4g],*i4SM»lSiAB8i4e3FFFe@D53S4888ei08AB88488e8l8eD58' i )| 

< ?9> 8tuffHex(& ccnES.E^], 1 ^! 1 itllAB8i7FFFFFFFS588.iACi88§@AB8855388838D58 5 ) ; 

< 88) StuffHsx(&!ConsC3I[72] ,"866811 883»e88?FC?99FFD78048688I8eAE88483FFF88DC0» ) ; 

< 81 > Stuff Hex (&l const 3.1 E 841 s a 8488&888§88884880088§F8i84i80SM«E8807FFFFFFFC88 " > ; 

\ . 8,4. £ 

< 83) /* File Cabinet */ 

< 84) Stuf4Hex<4ic'on.sf4][ t] /8887FPFFFC8888888e888C88t8i88888iC88882088e83498") 5 

< 85) 3" ''+-6<<x -c— r .:.;:;: , " 1 48e?8D:'e ro " ::r FFFFFD48g8£i8l88B8ACe888BFFFFED488*')| 

< 86> Stuff HexC&i COR3C4H24] V '§tAMi§mC8geeA87F82D48888A84i82AC8888A8?F82Q40e* > ; 

< 87) StuffHex<&icon5[4][3^] s s 8l«S«*2ACei08A08i82D4iSe8A8FF82ACei88A8e8i2O489") = 

< 88> 3t«ffH9x<&icon=f 4H481 /88A8^«^C8e8§E- c FFED4e§§8868889AC8888eFFFFED4S8"> ; 

< 8?) StuffHe <L :cr.HJ4 1 [6§3 ! B eSA0i;ir^:0HiyAs. F82D4ee88A84i82AC888eA87F82D48S B } ; 

< n> Stuf"fHex<«dc:cr,5l4li72] s "8iA8fii2AC0888Ae8082D40@8§A8FF82!AC8eeeA88Fi82D880'' 5 ; 

< ?t> StuffHex<&icoB5[43I343 ! B 63A0&892B38'3g88FFFFEEg888e588Ci98C88S88FFFFFF8888 ,i ) ; 

< ?2> ' 

< 93> /* Drawer */ 

< ?4> 3tuffHex<&iconst53[ Sl s ''ISIifHfl8Si89i8888§8886888e88Ef88888e88888888i88'"l ; 

< ?5> stuffHex<&5consi53 [123,* 889088606861;': seJv^ge^jesaeeBaeeeseoeeee^ea-jeees*); 

< 9.4> Stuff HexC&i const 5-3 [241 ,' 838888088888.1 88? 'vi%%%M'MMM%MMMMM%%%%MM* > 5 

< ?7> StuffHex<&iconst53[3i3,"808B8e98038?8888e8« - 88888888S@888881FFFFFF8 E } j 

< 98> 8tuffHsx<&i:ons[5} ; '48] 888838888838^8':' :C???'?7888i8D88808D8883FFFFFF188") ; 

< 9?> StuffHex<iicons[' ; 5][6l3 s !, '8828MSIi35888288ee8iiB80@28iFEeiO5e@828it28:AB3"); 

< 188> StutfKex<«k.0n3[5H72], !i 882plFS;0!5fcl8820888&!AC888288Bt8i5888S2828i61888 B )| 

< 181 > StuffHex(l£iconsI53[841 ! "88283FF8160ii82i888eiC88882i0M8I888883FFFFFF888 ,i ); 

< !82> )• 

< 183> 
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£"-3 


>ilei -LOWSR-HAC/C/SfiMPLE/SSSAMFLEX " [Ii-Jun~!?S63 " Page - 3 


{ 134/ 




< 1955 


drawl coritwh ich I con ,'h , w ) 


< 1865 


short which! con ,h,v; 


< I87> 




< 188) 


"{ 


< 1B9> 


BitHap srcBitsj 


< U8> 


Sect sPcRect,tfetRect ; 


< 112) 




( 1 i 35 


spcSi ts.baseftddr = (Ptr) SHcortstwhichleonjCBl 3 


< 114> 


srcBi ts.rowBytss — 6, 


< iis> 


SetRectCMsrcBi Is-bowds) ,6,8.48,32) ; 


< 116) 


srxRect = srcli tSibouMs; 


< 117> 


dstRect = sreRecti 


< 118) 


[-'•f58tRect":c.5 Rett,*, 5 


< tl9> 


Cop y6 i ts<&srcBi ts,feqd. theflort~>port8i ts,&srcRect ,1'dstRect jsr-cOr ,ni i ) ; 


< 126) 




< 121 > 




< 122>_ 




< 123) 


drawStyff O 


< 124) 




< 125) 


~ / 


< 126) 


short" i| 


< 127) 


Rsct tsirspRect; 


< 128) 


Polygon *»myPelyj 


< 12?) 


Region -**myRgni 


< ! Sfl ■> 


Pattern myPatternj 


< 131> 




< 132) 


Slu-f-f Hex (rnyPat tern, a 8i462ilfft2l40'8i8") j 


< 133) 




< 134) 


_SetRect<fefcemf>Reet, 8,8, 512,342) 5 




CI i j»Recfc<&t«ftpR*c t > % 


< 136) 


EraseRo«ndRect(4temp8ect,38,Z8)} 


i 137) 


Frame RoyndRect(&tempR : ect 5 3 : il 5 :2S) | 


< 138) 




< 13'?) 


/* draw two horizontal lints across the top */ 


( 141) 


Li neToCS'i I , i/) ; 




W ~; 'at*' * i vi = 


*' 143) 


Li neTotSl S f !?') \ 


< 144) 




< 145) 


/* draw diyidsr lines */ 


< 146} 


MoveTo<e,i26)i 


< 147) 


Li neToCSI 1,126); 


< 148) 


HoyeTotl,233); 


< 14?) 


LineTo(5il,233>j 


< 158) 


MoueTo(i78,28>; 


< 151) 


LineJo<178,342); 


< 152) 


Mc*V8To(34S s 2l)| 


< 153) 


LineTo(348,34i>| 


•s lo4) 
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£^ 



FilSi -LOyER-Mfte/C/S^SPLE/QSSiWPLE.C I t i-Jun-i986i Pao* - <5 



< 155) /* draw title «/ 

< 156) 

{ 157) TextFoRt<8')} 

< 158> TextSizeC.gJj 

< 159) TextMode-(srcOr>} 

< 168) Sp&ce£xtra<6>| 

< HI} f'oyeTQ<12e,14)j 

< 162} DrawStrirM}{*Look what you can draw wi th QuickDraw"); 
{ 1 62 ) 

< tiA> 

< 165} /* — ■ draw text samples" — - — ■ */" 

{ 166} 

< 16?} MoveTcrf68,33)j BrawString^Twt'); 

< 168) 

< 169} TtxtFaseCbelcf); 

< i 76 ) Mov sloi 54 , 53) ; Br awS t r i n f? * feel si" ) j 

< 171) 

< 172) TsxtFac8( italic) 5 

< 173) McweTo<54,68)] DrawStringCi talk") i 

< 174) 

< i?5> TextFace<underline>; 

< 17,6) MoMeTo<54,83)| DrawString<"und8rline">? 

< 177) 

< 178) TextFa,ce(outl ine) j 

< IT?') MoveTo<54,9S)-} Br'awStringCwtline 1 ') ;, 

< 188) 

-. :.5i > ~? "FiC* =. ••;■;■.;,;.:.,- j 

< 182) Mo«eTo(S4,it3)'} $rawStrirtg(*'sih»jow ,, > | 

< 184) TextFaceinorcnal )} 

< 185) 

< 186) 

< 187) /* • — draw Li m samples */ 

« 18S> 

< 189) HovetoC248,33> j OrawStringC "Lines") ; 

< 199) MoveToC 280,31) 5 Line<li8,38)} 

< 191) 

< \92'> PsnSize<3,2) | 

< 193) MQveTo(2@8 5 48)j Line('118,3«>5 

< 194) 

< 1?5> PenSiz*<£,4)"5 

< 196) MoveTo(24@,5e); LineCn§,3§)| 

< 197) 

< 198) "PenSJze.(12,8)| 

< 199) 'PeriPat(qd«gra>')j 

< 288 > MoveTo(288,&4)5 Lirse«l!8,38) j 

< 28 1 > 

< 282) PenSize<I5,8) 



s 

283) PenPat<myPattern>; 

284) MoyeTo<28«,88>| Lined 18,3ft) { 

285) PenNormal O f 
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£^ 


Fi lei -L 


Du ER-HAC/I,,' SAMPLE GDS& !?LE . C 


iii-Jur<-1986] Page - 5 


'< 2U) 






<• 267) 






< 2ee> 






< 289) 

< 210> 

< 21 i > 


/# g raw rectangle samples" -— */ 




Mov'sToC 39g,33), : ; Dr-awStr i ng< "Rec t ang! es" 5 j 




< 212) 


SelRect(iterapRect 5 368,42,415, 78); 




< 2I3> 


FrsmeRee t C&temjsRst t ) i- 




< 214) 






< 2!5> 


0-ff5*tSect(4t«BpRect,28,ii)j. 




< 2I6> 


PenSize(3,2>.j 




< 2I7> 


ErassRecK&.tempRect); 




< 218) 


FraraeRsctiiitemp-Rect) 3 




< 21 9> 






< 228) 


W-f.setSect(&tsaiptect,.2i ; ,i f ) 5 




< 221 > 


Pair>tRecHMempRect>| 




< 223) 


QHsetRectX&tejRpRect r 28,ii>|. 




< 224 > 


PenNormal O j 




< 225> 


Fi 1 lRect(&i«mpRect , qd.gr ay) ; 




< 226) 


FrameR-eqtCMemfjRecOi 




< 227 > 






< 228) 


Off se.tRec t4&te«pRect ,21 $ 1 1 > | 




< 229) 


FI liRectCltesnpRect ,myPatlsrn> ; 




< 238) 


Fr ameRsc t CMempRs c t > ; 




< 231 > 






< 232) 






< 233) 


/# _, .^ raw roufldRect fancies »/ 




< 235) 


HowsTo(45,i4S) ; DrawStrin^RoundRects") ; 




< 236) 


8eiftect<&teiTJp'R«t:t ,28., I49 s 75 f 17?)"; 




< 237) 


Frame RoundRecttfetempRec? s 2%, 28) 3 




< 239? 


G-f -f ss IRec t (Mempfec t , 28 , 1 1 ) j 




< 248) 


>enSize£3,2)} 




< 24i> 


EraseRou.ndRet t (Me.mp.Rec t , 38 ,.2S>| 




< 242 ) 


Frame , RaundRect<4iteiiipRect,30|28) \ 




< 243) 






< 244) 


Off 5etRect{&tsmpRect,29 j 1 1) 5 




< 245) 


Pa i n tRoun.dRf c t CMempRee t , 31 ■ ,28 ) 5 




< 246) 






< 247) 


Of f setRec t(&teisp.Rec t ,28 , i I ) ; 




< 248) 


PenNorieal ( 5 ; 




< 249) 


F 1 iRo , jndRect<4Uv * -J "2,,2«!,qd.s-a sj 




< 256) 


FraseRottndRsctC&tempRect ,38 ,21) ; 




< 251 ) 






< 252) 


B-f -f m tRec t<&t*npRec t ,2® , 1 1 ) 5. 




< 253) 


F i I '. RcundRec t CMemf Rsc t , 38 ,21 ,ayPat ter n ) \ 




< 254) 


FraseRsandRee t <&tempSec t , 38 ,2S> \ 




< 255) 






< 256) 


/s {j raw BitMap samples */ 
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< 25?) 

i 258) Ho^eTQC232»i.4t5| DrawStrin^'BJ tMaps") j 

< 259) drawIcor)(8il8l,i48)f 

< 2*8 > drswIconU, 232,143)} 
.< 261 > drawIcon<2, 284,348) 5 
<■ 262) drwIconCS, i;B8,,l?2)| 

< 26B> drawlcon(4,.232,192) 5 

< 2£4> drawIcon<5, 284,192) j 

< 2*5> 

< 26*> 

< 2<S7> /*" * — — dr-aw ARC samples — *— */ 

< 268> 

< 269> HoveTe<418,W8>| DrawStrin§<"Apcs ll )| 
C 278> SetB«ct«Memp«eet s 36«.,i4?54?-& s 220>; 

< 27 1> Fi!lArc(8£tempRect,135,d5 f -^d.dkGray); 

( 272) FiHArc(&tempRe-ct,28e,13S 5 myfattern); 

< 273> F I Ar c <; & 1 9ir.^- Se c t , 33* ^ : ;ti.gray>; 

< 274> FrameArcdstempRect, 135,270) j 

< 275) 0f^setRsct<4tempRact 5 2?,e); 
<■ 271) Pain*.Apc(«£tempRect,45,9e)j 

< 277> 

< 278) 

{ 27? } /* draw Polygon swplf -s" 

< 288> 

< 281 > f*loMsTo(52,247)|. "OrawS'tririgi^Polygoris 8 ) ; 

< 282) myPoly •» Op*nPo>y<>*, 

< 283) "HoveTo<28,284>} 

< 284> LineTo<28,2<5'8>| 

< 285) LineTa<32,.256)} 

< 28d> i.ineTo<75,256>-; 

< 287> LlneTD<42»27«>; 

< 2S8) LineTo<?5,284); 

< 28?) LineTo.<2'8,284); - 

< 2f0> ClosePolyO; /* end of .def tni t ion */ 



v 



501 \ 

*: 7 ! / 



< 292) FramePolydnyPtsly); 

< 293) 0ffsetPolyCffiyFo]y,2a,lI)} 

< 294) PenSize-<3,2)| 

<■ 295) ErafePoly<royPoly>5 

< 2?£> FramePoly<myPoJy>} 

< 2?7> OffsetPoly<myPoly,26,iI)f 

< 2?8> Pair«tPo1y(myPo!y) j 

< 29?> QtfsetPo1y(myPoly,28,113 5 

< 308 > PenNormalpj . 

< 38i> Fil lPoiy<myPoly.,i£}.digray); 
i 382) FraraePolyCmyPoly) ; 

< 3S3> OftsetPo1y<rayPo3y,28,ll)j 

< 304) Fil IPoly(myPoly,myPattern>f 

< 3§5> Fr-amsPoIyCrriyPeiy); 

< 3&d> KI 1 1 Pol yCfssyPo! y) 5 

< 3I7> 
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File; <0WER-HAC/C/M1Pte/S©SAHPL.E . C 



[ii-Jun-!?863 Page"- ? 



< 388) 

< 389) 

< 318) 

< 31 i> 

< 312) 

< 313.) 

< 314) 

< 3!5> 

< 3 Id) 

< 3I7> 

< 3iR"> 

< 3i9) 

< 328) 

< 321 > 

< 322) 

< 323) 

< 324) 

< 325) 

< 326) 

< 32?) 

< 328) 

< 32?> 

< 338) 

< 331) 

< 332) 

< 333) 

•' 335> 

< 33d> 
\ 337) 

< 338) 

< 339) 

< 343) 

< 341) 

< 342) 



< 344) 

< 345) 

< 346) 

< 347) 

< 346) 

< 34?) 

< 358) 

< 351) 
\ 3?2*j 

< 353) 

< 354) 

< 355) 

< 356) 

< 35?) 

< 358) 



/f. — - — . . demonstrate Region Clipping 

MoMeTo<232,24?)j DrawStNtHjCRegi ons !! ) 5 
myRgn - NewRgnOf 
OpenRpO | 
ShowPenO ; 

SetRectt&tempRect, 190,255, 328 ,328) ; 

Fr-ameRoundRect(&tempRect s 24,i<5)| 

McweTo<i95,3l2)} /"* de-fine tr larifular- hole #/ 
LJneTeC 236,278) 5 
LineTc(265,312)| 
LineToU 95,312); 



/* oval hole */ 



Se tRec t C& tempRec t ,.2A8 ■ J 2&2 ,3ii , 382) 
Frame Oval (itempRect) j 
HidePenO; 

CI oseRgrtCmyRgn) 5 ■ /* ewd of definition */ 

SetCl ip<myRgn> j 

lor <i=»8jf '<*<5 ;!■♦+> C 

Hoy6To(198,246+12«i); 

DrawString(* Arbitrary Clipping "); 

} 



I i pRect(&qd.the?ort->por tRec't) j 
sposeRgnXmyRgn) \ 



/s 



draw oual samples — 



MoueTQ(4«6»247)) DrawStriiagCGyals") 5 
SetRect(&terapRect,36B,42,4i5,78)5 
Se tRec t (&t«npRec t , 368 .,256 , 415,234) ; 
FrataeQya? <&tempteot> ; 

Of f setRecM&tempRect ,28 , 1 i > 5 

P«iSizeC3,2)}' 

Erase Oval <&tempReet) ; 

FramsOua! CMempffrtt) ; 

Of f setRectC&tempRect ,28 , 1 1 > \ 
Pa i n tOval CMempRec t ) ; 

Of-fsetRectCMempRect ,26 , 1 ! ) ; 
PeriNopmal O 5 

Fi 1 1 Oval <&tempRect, qd.gr ay) | 
Fr-ameOvaS (fctempRect) \ 



is. Workshop C Hactntosh Samp' 



-"V -' ' 






Ex Libris • David T Craig • August 2009 



Page 0206 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 



Files -L0U£R-MAC/C/8AMPtE/§&SAMPLE . C 



00 £^ 
, 7 0OJ 



"*ys 



< 


35?> 




< 


368) 


0-f i setRectC&tempRect ,29 , 1 1) j 


< 


361) 


Fi 1 TOval <&temp"Rect, myPattern) j 


< 


M2> 


FrameOv&J CMempReci) ? 


< 


3£3) 




'*■. 

< 


364> 
&5> 


> /* tirawStu-ff */ 


< 


3id> 




\ 


36?) 


ma i n ( ) /* ma i n pvogr mi */ 


■>-. 


368) 




^ 


un 


{ 


< 


378) 


Ini t6ra-f<&qd.tNPort)j 


< 


371) 


0penPort(4uiyPort>j 


< 


3?2> 


Ini tCursorO; 


/ 


373) 


Hit&CupsorO j 


< 


3?4> 


Ini tFontsO ; 


< 


375> 


Pai rvtRecK&qd. thePort->portRect> | 


< 


376> 


ini.ticonsO j 


{ 


377) 


drawStuf-fO; 


\ 


378) 


while <!SuttonO)f 


i 


37?> 


} 


f 


388 > 




/ 


381 > 




{ 


382 > 




< 


383) 




/ 
\ 


384) 




i 


385) 





Lisa Workshop C Macintosh Sample AppH cat 



fon 
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^""7 



File! -LOyER-l«C/C/SAMPLE/QDSAMPLE,R [li-Jun-19863 Paoe - 



i I) * Rssource File qds&ntple 

< 2) 

< 3> 

< 4> nsac/c/sample/qdsample.rsrc 

< 5> 

< "A) type CODE 

< 7> mac/c/sampl e/qdsamp 1 e , 8 

< 8> 

< 9> 



Lisa 'WcriCsfisp C Macintosh Sample Resource File 
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Apple Lisa Computer Information 



Lisa Workshop C System 
Manual Extra 



Lisa C 
Packing Slip 



Ex Libris • David T Craig • August 2009 Page 0210 of 0212 



Apple Lisa Computer Information • Apple Lisa C Manual • Apple Computer Inc. • 1985 




f?~l 


FROM' APPLE COMPUTER, INC. 


M \fiOt 


M ILESTOHE 6R0«P LTO . 


/ f fl mw/i 


MAULING FACILITY 


l/fV 1 iOlLf 


3250 KELLER STREET /SUITE 1 * ' * ^ ^* 


SANTA CLARA CA 95054 






&MBSBBLMM. 


TO: P3.. INC 


" 1211 


DAVID CRAiG 


UPS 


949 PARKLANE CTR 




VICHITA KS 


67218 


PRODUCT 


~ DESCRIPTION OTY SHIPPED " QTY BACKORDERED 


FG19 


APPLET ALK 


FC31 


C LANGUAGE 1 


F033 


DEC *S5 ADDITION 


FG34 


MAY '85 SUPPLEMENT 


F035 


LASERWRITER 


FG36 


MARCH '86 AMOTION 


FG40 


'85 APPLE TECH NOTES 


FG4? 


'85 MAC TECH NOTES 


F642 


'86 MAC TECH TOTES 


FG43 


"86 APPLE TECH NOTES 


FG44 


'86 MAC TECH NOTES/DISK 


FG45 


■86 APPLE TECH NOTES/DISK 


FG46 


'85 MAC TECH NOTES/DISK 


F64? 


'85 APPLE TECH NOTES/DISK 


THIS IS A PACKING SLIP ONLY!!!! S8T AH INVOICE!!!! 
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